addons-server/docs
Kevin Meinhardt 9e116d7416
Migrate dependencies to /data/olympia (#23015)
- Updated docker-compose.yml to mount dependencies in /data/olympia/deps for better organization.
- Modified Dockerfile to set environment variables for dependency directories and ensure proper ownership.
- Adjusted Makefile-docker to remove NODE_MODULES variable and streamline npm commands.
- Updated documentation to reflect changes in dependency paths.
- Refactored install_deps.py to clean up dependency directories and removed obsolete package.json copying logic.
- Updated settings_base.py to reference new dependency paths.
2025-01-28 16:58:25 +01:00
..
_intersphinx
_static
_templates
extensions
screenshots
settings
topics Migrate dependencies to /data/olympia (#23015) 2025-01-28 16:58:25 +01:00
Makefile Make up the docs (#22313) 2024-08-14 12:12:54 +02:00
README.md Remove all reference to update_deps* (#22662) 2024-09-16 10:42:45 +02:00
__init__.py
build-github.zsh
conf.py Bump sphinx-rtd-theme from 2.0.0 to 3.0.1 in /requirements (#22753) 2024-10-21 21:04:39 +02:00
index.md Add basic documentation about the various types of logs that AMO has (#22702) 2024-09-25 15:25:42 +02:00
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