Commit 90a03ce
committed
docs: add bazel sphinx_build_test replicating ReadTheDocs CI
Adds a hermetic Bazel `py_test` target that runs the same Sphinx
documentation build performed by readthedocs.org/openroad, catching
broken cross-references, malformed markup, missing files, and toc.yml
issues locally before they reach CI.
- `//docs:sphinx_build_test` runs `sphinx-build -b html` with pinned
Python deps from `@openroad-pip` (no system Sphinx required).
- Tagged `doc_check` for filtering: `bazelisk test --test_tag_filters=doc_check //docs/...`.
- Mirrors conf.py setup (main symlink, README2.md prefix swap, messages
glossary generation, doxygen stub) and strips `bazel-*` symlinks to
prevent recursive scanning.
Fixes #9885
Signed-off-by: alokkumardalei-wq <alokkumardalei2@gmail.com>1 parent bf6f201 commit 90a03ce
5 files changed
Lines changed: 666 additions & 1 deletion
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
| 2 | + | |
| 3 | + | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
0 commit comments