Document structure Edit

Highlight: Follow a defined document structure throughout your documentation.

  • Don’t write walls of text in your documentation. Follow a defined structure throughout your documentation.
  • Break up long pages of text into paragraphs, lists, and illustrations. Use proper heading hierarchy.
  • Maintain a uniform structure for your document. Emphasize important points both stylistically and visually.
  • Use concise and simple sentence structures. Ensure that your tone is succinct, natural, and friendly towards the reader.

For more information, see Accessibility.

Text formatting

  • Use consistent typographic formatting and font sizes for your documentation.
  • Use bold formatting for word emphasis and UI elements. Additionally, use italics formatting for names, terminology, etc.
  • For more information, see Accessibility and the Formatting section.

Top ↑

Encoding

  • Ensure that proper character encoding is used. The UTF-8 character encoding is used universally, and is the preferred form of encoding.
  • Unicode encoding is preferred because of its single character encoding, by which you can handle any specific character that is needed. Using Unicode throughout your system also removes the need to track and convert between various character encodings.
  • Both developers and writers should use UTF-8 character encoding to ensure uniformity and eliminate inaccuracies in their content.
  • For more information about character encoding, see W3C – Character encodings for beginners.

Last updated: