Voice

We want our content to be simple, objective, and professional. However, we also want to maintain a conversational and engaging tone.

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...”