Writing Clearly

For anyone who writes or edits text with or for the user: documentation, slides, web and UI copy, emails, messages and commit messages. Collected from writing instructions and from corrections made during a review of training material.

The reader should get the point at first read, trust that it's accurate, and know what to do with it. A vague phrase feels finished to the writer, who already knows what it means; the reader has to find out what it means.

Contents