Sphinx Docs

• Autodoc does not process Bash or other non-Python sources; document these with literalinclude or language-specific domains (e.g., sphinxcontrib-bashdomain) instead of relying on comments alone.
• When documenting shell scripts, add a dedicated RST page that lists functions, arguments, and usage with short examples.
• Treat inline comments as implementation notes; keep canonical API docs in Sphinx pages so they build deterministically.

Build/Deploy Integration

• Locate deployment or release workflows in .github/workflows/ and confirm where build artifacts are assembled.
• Add a docs build step that runs after dependencies are installed but before deployment/publish steps.
• Ensure docs dependencies are installed (e.g., pip install -r docs/requirements.txt or pip install .[docs]).
• Fail the pipeline on docs build errors to prevent deploying broken documentation.
• If docs are deployed separately, add an explicit job that depends on the main build and publishes the HTML output from docs/_build/html.

Quality Checks

• Fix warnings for missing references, duplicate labels, or broken toctree entries.
• Keep the docs build deterministic by pinning versions in docs requirements when needed.