IDM style guide and doc guidance#

This documentation set includes the “nuts and bolts” information about our documentation toolchain, standards, and how to write docs and Python docstrings. For a high-level overview of our documentation philosophy, see https://gatesfoundation.atlassian.net/wiki/spaces/SP/pages/2893316655/Software+Documentation. This docset includes information on the following:

  • How to engage with the content team

  • How to set up new documentation sets for software projects

  • The documentation build toolchain

  • Getting started with RST, Sphinx, and Read the Docs

  • Style guidelines for docstrings and RST files

If you still have questions after consulting the information here or notice information that is out of date or incomplete in some way, file a ticket in the doc-guidance repository so we can update the guidance.

Contents#