Guidelines

• Use active voice.

  For example, write “We recommend that you do not edit the underlying code.” instead of “It is recommended that you do not edit the underlying code.”

• Write in the second person narration.

  For example, write “You can use the History tab to restore a file to the previous state.”

• Keep it simple and direct. Be conservative in adjective and adverb usage, and use simple, common words.

  For example, write “Now...” instead of “Once you have done that...”