ddc10704fb
* rm sponsored, verified * more clean-up * still accept obsolete groups as search params, behind a gate * add clean up migration |
||
|---|---|---|
| .. | ||
| _intersphinx | ||
| _static | ||
| _templates | ||
| extensions | ||
| screenshots | ||
| settings | ||
| topics | ||
| Makefile | ||
| README.md | ||
| __init__.py | ||
| build-github.zsh | ||
| conf.py | ||
| index.md | ||
| watcher.py | ||
README.md
Add-ons Server Documentation
This is the documentation for the use of the addons-server and its services. All documentation is in plain text files using primarily myST and is built using Sphinx. Some docs, especially API docs are still written using standard reStructuredText but most future documentation should be written in markdown.
If you're unsure, activate your virtualenv and run:
make up
The documentation is viewable at http://addons-server.readthedocs.io/, and covers development using Add-ons Server, the source code for Add-ons.
Its source location is in the /docs folder.
Note: this project was once called olympia, this documentation often uses that term.
Build the documentation
This is as simple as running:
make docs
This is the same as cd'ing to the docs folder, and running make html from there.
We include a daemon that can watch and regenerate the built HTML when
documentation source files change. To use it, go to the docs folder
and run:
python watcher.py 'make html' $(find . -name '*.rst')
Once done, check the result by opening the following file in your browser:
/path/to/olympia/docs/_build/html/index.html