Isolated builds
An isolated build processes a single docset.yml — one documentation set from one repository. This is the default when you run docs-builder locally.
An isolated build can be:
- Published on its own — as a standalone static site to GitHub Pages or any other host (see Publish)
- A building block for a larger assembler or codex build, where many isolated builds are composed into a unified experience
- Install docs-builder
- Create a
docs/folder with adocset.ymlandindex.md - Run
docs-builder serve— see Serve and preview
Even in isolated mode, cross-repository links are validated against published link indexes from the link service, ensuring your cross-references are valid without needing to clone other repositories locally.