Use this checklist to communicate in a way that is clear, helpful, and consistent with the rest of Docker Docs.
Active voice is specific and removes ambiguity.
In active voice, the subject of the sentence (the customer or the system) does the action.
Sentences that use active voice are easier to read. Active voice makes it clear who has done what and to whom. Plus, active voice keeps sentences direct and more concise.
Helping verbs such as is, was, or would may indicate that you're writing in passive voice. And, if you can add the phrase 'by zombies' after the verb, you're writing in the passive voice.
|Increase productivity with Docker Desktop.||Productivity can be increased (by zombies) with Docker Desktop.|
|If you remove items from a grid, charts automatically refresh to display the change.||If items are removed (by zombies) from a grid, charts automatically refresh to display the change.|
Write short, concise sentences. Punchy sentences are faster to read and easier to understand.
This helps find the information they need quickly and easily.
For example, 'Install Docker Desktop'.
Checked that the left-hand table of contents title in docs.docker.com, matches the title displayed on the page
Use relative links to link to other pages or images within the GitHub repository.
For information on how to add redirects, see Source file conventions.