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.