Documentation

High-quality documentation is essential for scientific software, making your tools accessible to users and facilitating collaboration among developers. This section covers best practices for creating, organizing, and maintaining effective documentation.

What You’ll Learn

In this section, you’ll discover:

  • Documentation automation: How to generate documentation directly from your code
  • Documentation style standards: How to maintain consistent and readable documentation
  • Validation techniques: How to ensure your documentation examples remain accurate

Well-documented scientific software is more likely to be adopted, correctly used, and contributed to by the community. The practices in this section will help ensure your software’s documentation meets these goals.