add details to user-facing text