DOC Upgrade to jupyterbook v2 and add proper landing page#1458

Merged

romanlutz merged 22 commits intoAzure:mainfrom

romanlutz:upgrade-jupyter-book

Mar 13, 2026

Commits on Mar 12, 2026

Upgrade Jupyter Book 1.0.4 to 2.1.2 with griffe-based API reference

romanlutz
and
Copilot
committed
Gitignore doc/_api (intermediate JSON), keep doc/api (reviewable markdown)

romanlutz
and
Copilot
committed
Gitignore doc/api too - fully auto-generated from source

romanlutz
and
Copilot
committed
Use make docs-build in CI workflow (consolidates API gen + JB build)

romanlutz
and
Copilot
committed
Add comments to Makefile and restore docs-api target

romanlutz
and
Copilot
committed
Restore remove_notebook_headers.py and sanitize_notebook_paths.py

romanlutz
and
Copilot
committed
Restore notebook pre-commit hooks (remove headers, sanitize paths)

romanlutz
and
Copilot
committed
Add fast doc validation pre-commit hook (replaces validate_jupyter_book.py)

romanlutz
and
Copilot
committed
Move pydoc2json.py and gen_api_md.py to build_scripts/

romanlutz
and
Copilot
committed
Add JB2 API workaround context and tracking issue link to scripts

romanlutz
and
Copilot
committed
Restore test_sanitize_notebook_paths.py

romanlutz
and
Copilot
committed
Fix top navbar URLs (JB2 converts underscores to hyphens in URLs)

romanlutz
and
Copilot
committed
Fix all nav URLs - JB2 strips leading numbers and converts underscores to hyphens

romanlutz
and
Copilot
committed
Remove test_api_documentation.py (validated api.rst which no longer exists)

romanlutz
and
Copilot
committed
Skip auto-generated api/ dir in doc validation (gitignored, built in CI)

romanlutz
and
Copilot
committed

Commits on Mar 13, 2026