How-to guides

These guides will walk you through the processes involving setting up, maintaining, and contributing to the starter pack.

Basic setup and maintenance

Set up, configure, upgrade, and customize your project to keep it organized and aligned with your documentation needs.

• Configure your project
• Build and preview
• Publish on Read the Docs
• Enable Google Analytics
• Update your starter pack
• Test the Ulwazi theme
• Troubleshooting

Optional features and customisation

As your documentation grows, you may need more advanced features to support richer content. This can include customising the build system, adding diagrams as code, rendering API references, interactive tables, and custom HTML.

While some of these features are available by default in the starter pack, others may require additional extensions.

The following guides will help you get started:

• Optional customisation
  • Bridge project and docs builds
  • Customise PDF output
  • Use Spread to test commands in documentation
  • Use custom HTML templates
  • Add Mermaid diagrams
  • Add Python docstrings
  • Add OpenAPI specifications
  • Add interactive tables