Multi-Source KB · Addon

Many repos. One knowledge base.

Stitch documentation from multiple Git repositories (and future sources) into one unified knowledge base.

acme/api-docs

47 articles

acme/sdk-js

32 articles

acme/sdk-python

28 articles

Merged KB

API · Reference api-docs
Guides api-docs
SDK · JavaScript sdk-js
SDK · Python sdk-python
Changelog api-docs

Many repos, one KB

Stop centralizing what shouldn't be centralized.

  • Add repos one at a time
  • Different teams own different folders in the same KB
  • Branch + tag versioning per repo
  • Repo metadata tagged on every article

acme/api-docs

47 articles

acme/sdk-js

32 articles

acme/sdk-python

28 articles

acme/your-kb

107 articles · 3 sources

Per-folder routing

Map repo paths to KB folders.

Pick which folder of which repo mounts where in your KB. Mix monorepo subdirs and standalone repos. Re-index automatically.

yaml
1 routes:
2 - repo: acme/api-docs
3 path: docs/
4 mountAt: /api
5 - repo: acme/sdk-js
6 path: README.md
7 mountAt: /sdk/js
8 - repo: acme/sdk-python
9 path: README.md
10 mountAt: /sdk/python

Per-repo permissions

Who writes to api-docs ≠ who writes to sdk-js.

  • Repo write access stays with the repo's team on GitHub/GitLab
  • KB readers see the merged view
  • GitHub branch protections still apply to PRs
acme/api-docs · API Team
sarah@acme.com admin
acme/sdk-js · JS SDK Team
marcus@acme.com write
acme/sdk-python · Python SDK Team
jamie@acme.com read

One KB. As many repos as you've got.

$29/mo per KB. Unlimited repos.