Verbs Edit

Use precise verbs to write clear, succinct sentences. Use active voice while writing documentation. Some exceptions for using passive voice can be made. For more information, see Voice.
Also, write in present tense rather than future tense. For more information, see Tense.

For writing reference documentation to explain a procedure, phrase the procedure in terms of what the action does, not what the user/developer would do. These forms of verbs are also used in glossaries and word usage dictionaries.
Usually, the only difference between the two verb forms is an -s at the end of the verb. An example of the verb without -s would be how most developers write git commits: Add new file.

Examples

Don’t use verbs as nouns or nouns as verbs.

For more information, see Verbs as nouns.

In general, use an indicative mood of verbs that convey a factual, friendly, and natural tone without being condescending towards the reader.

Types of verb moods

Avoid using subjunctive and interrogative moods while writing documentation. Any form of uncertainty, hypothesis is confusing for the reader. Don’t change moods within a sentence.

Last updated: April 5, 2021