beluga icon indicating copy to clipboard operation
beluga copied to clipboard

Build documentation with Bazel

Open nahueespinosa opened this issue 5 months ago • 1 comments

Feature description

Currently, we rely on a Makefile and scripts to generate documentation. These tools have a list of Python requirements and system dependencies. Bazel can probably do a better job in terms of dependency tracking and incremental changes without having to spin up a container to generate docs.

Implementation considerations

rules_python comes with rules to generate sphinx docs: https://rules-python.readthedocs.io/en/latest/sphinxdocs/index.html#

While it is primarily oriented towards docgen for Starlark code, the core of it is agnostic as to what is being documented.

EDIT: The clanky bits have more to do with doxygen than make.

nahueespinosa avatar Sep 23 '25 15:09 nahueespinosa

I like the idea.

hidmic avatar Sep 23 '25 15:09 hidmic