Document toolboxDocument toolbox

Active voice

Use the active voice to make your sentences direct and easy to read. The active voice conveys a strong and clear tone, while the passive voice is weaker.

With the active voice, the subject of the sentence does the action. With the passive voice, the subject of the sentence has the action done to it.

However, the passive voice is acceptable in the following situations:

  • In an error message or troubleshooting content when the active subject is the user.
  • The subject of the action is unknown, or you want to emphasize the object on which the action is performed.
  • The sentence in active voice sounds unnatural or complicated.