Loading

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
  1. Install docs-builder
  2. Create a docs/ folder with a docset.yml and index.md
  3. 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.