How-to guide

Publish or update GitHub Pages docs

The docs are static HTML, CSS, and generated JavaScript payloads committed under docs/.

Regenerate Static Data

python3 scripts/build_docs_data.py
python3 scripts/build_benchmark_run_data.py

The first command refreshes the question browser. The second refreshes the historical run answer payload at docs/runs/gpt-opus-2026-05/benchmark-run-data.js.

Check Routes

GitHub Pages serves this folder directly, so links are plain relative paths. Keep the overview at docs/index.html, guides under docs/guides/, questions at docs/questions.html, and archived runs under docs/runs/<run-id>/.

Run Tests

python3 -m unittest tests.test_docs_site