clarify options/details keys