Rewrite $1 to be clearer, cleaner and more concise, and less wordy and ambiguous.
Make clear distinctions between different behaviors.
Use active voice verbs. When applicable, use "we" to read naturally for a team document.
Focus on simplicity, precision, and pragmatism.