Mozilla Services Documentation

This repository hosts the source documentation for the "docs" site at:

https://docs.services.mozilla.com

To build it you will need to install python (see .python-version for supported version) and virtualenv, then do the following:

$ make build

This should produce a "build/html" directory containing the generated HTML documentation.

Publishing to Read The Docs

Ensure that the .readthedocs.yaml file is up-to-date with the current configuration. Do not specify sphinx: configuration: option as this may over-ride the default Read the Docs conf.py file.

e.g. ensure that the following lines are commented.

# Build documentation in the "docs/" directory with Sphinx
# sphinx:
#   configuration: conf.py

The project is automatically monitored by Read the Docs, so any change pushed to the master branch should invoke a build. Monitor the builds to see any errors and correct as appropriate.