bst-docs 0.0.1

API Reference Generator for Buildstream Projects

bst-docs

This is a

Usage

To build a documentation folder for a given repo: uv run bst-docs build $REPO_PATH

Or to build a documentation folder for a network repo (clones using your .netrc): uv run bst-docs build $REPO_URL

These commands will produce a folder full of markdown files which can then be imported into the documentation portal of your choosing.

An example zensical.toml has been provided to view the results in ./output, to use: uv run zensical serve

Configuration Options

Usage: bst-docs build [OPTIONS] [PATH]

Options:
  --depth INTEGER          Depth of network crawling to perform
  --output TEXT            Destination folder for markdown files
  --clean BOOLEAN          Remove all files from cache & output directories
  --html-elements BOOLEAN  If true, html elements will be embedded in markdown
                           files otherwise pure Commonmark markdown will be
                           used
  --overwrite BOOLEAN      Overwrite output directory if true, otherwise
                           errors if output files exist
  --help                   Show this message and exit.

Design Choices

• Should be possible to render everything as MD, html is for nicenesses