From the notebook

Clear writing: give a reader what they need to act

Replace a vague message with a specific instruction while preserving what is known and unknown.