blob: ac857d625b3ba724cd6c6e612f1e956f7c5c4a05 [file] [log] [blame] [view]
# Docgen using Sphinx with Bazel
The `sphinxdocs` project allows using Bazel to run Sphinx to generate
documentation. It comes with:
* Rules for running Sphinx
* Rules for generating documentation for Starlark code.
* A Sphinx plugin for documenting Starlark and Bazel objects.
* Rules for readthedocs build integration.
While it is primarily oriented towards docgen for Starlark code, the core of it
is agnostic as to what is being documented.
```{toctree}
:hidden:
starlark-docgen
sphinx-bzl
```