Skip to content


Repository files navigation

Mozilla Services Documentation

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

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 file.

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

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

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.