Summary
https://developers.google.com/tech-writing/one
Grammer
- Use terms consistently.
- Avoid ambiguous pronouns.
Active voice
- Prefer active voice to passive voice.
- Choose strong verbs.
- Pick specific verbs over vague ones.
Clear sentences
-
Focus each sentence on a single idea.
-
Convert some long sentences to lists.
-
Eliminate unneeded words.
## Lists and table
-
Use a numbered list when ordering is important and a bulleted list when ordering is irrelevant.
-
Keep list items parallel.
-
Start numbered list items with imperative words.
-
Introduce lists and tables appropriately.
## Paragraphs
-
Create great opening sentences that establish a paragraph's central point.
-
Focus each paragraph on a single topic.
## Audience
- Determine what your audience needs to learn.
## Documents
-
Fit documentation to your audience.
-
Establish your document's key points at the start of the document.