Documentation guide

This guide gathers the collective wisdom of the Write the Docs community around best practices for creating software documentation.

This is a living, breathing guide. If you’d like to contribute, take a look at the guidelines for contributing to the guide. If you have any questions about contributing, you can send them along to guide@writethedocs.org.

Also feel free to send us any additions in any format to support@writethedocs.org.

Distribution

  • Common Output formats
  • Documentation Styles
    • Slate
    • Read the Docs Theme
    • Alabaster

Writing environments

  • Text Editors
  • IDEs
  • Live Previews

Examples

Documentation comes in many variations. Here are some examples to inspire you:

Write the Docs resources