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