The public documentation site for RAPID (Roman Alerts Promptly from Image Differencing), built with Sphinx, the MyST parser, and ABlog, hosted on Read the Docs.
Where every statement about RAPID lives, and what this site is, is the
documentation design: system/documentation.md.
Every check that runs in CI runs locally first; nothing is pushed unverified.
uv venv .venv --python 3.12
uv pip install --python .venv/bin/python -r requirements.txt
scripts/check-public-safety.sh
.venv/bin/sphinx-build -W --keep-going -b html . _build/html
.venv/bin/sphinx-build -b linkcheck . _build/linkcheck
scripts/acceptance.sh _build/html
Read the Docs project roman-rapid: https://roman-rapid.readthedocs.io/.
Every push to main builds latest through the repository's webhook;
pull requests get preview builds. The project is owned by a RAPID role
account, with individual maintainers added on top.
- Sections hold pages only when they have content; no placeholders.
- A post is a file under
log/withblogpost,date,authorandcategoryfront matter; posts are never revised after publication. system/is the published copy of the design corpus. Until the planning repository's decision register retires, edits to those fifteen documents are made there and synced here; after that, here.- Dependencies are pinned exactly in
requirements.inand resolved torequirements.txtwithuv pip compile requirements.in -o requirements.txt --python-version 3.12 --generate-hashes.
Pull requests are welcome; the checks above must pass. The pipeline repository's CONTRIBUTING and CODE_OF_CONDUCT apply here too.
The configuration, scripts, and templates in this repository are licensed
under the BSD 3-Clause License (see LICENSE). The documentation text is
licensed under CC BY 4.0.