Maintaining documentation

Markdown under docs/ and README.md is the documentation source. HTML is generated into ui/doc/ and served at https://asi-database-node-api.arybit.co.ke/admin/doc/ by the deployment gateway.

python -m pip install -r tools/requirements-docs.txt
python tools/build-docs.py
python tools/build-docs.py --check

The builder renders every docs Markdown file recursively, renders README as readme.html, and regenerates one SQL reference Markdown/HTML page per Database SQL file plus a catalog. SQL metadata comes from manifests and source declarations. No database connection or deployment is performed. Generated pages use escaped Markdown and local CSS, support offline browsing, and rewrite internal Markdown links to their HTML equivalents. Edit guides in docs/; SQL reference pages are regenerated from SQL rather than edited manually.

Preview the static UI locally with python -m http.server 8000 --directory ui, then open http://localhost:8000/doc/. Production administration JavaScript requires HTTPS; these static documentation pages do not require JavaScript.