Repository Registry
Single source of truth for every repo in the Documentation System —
every Tier 1 standalone doc repo and every Tier 2 aggregation hub.
Each entry declares the repo’s canonical project slug (which is the
label prefix for every cross-reference target the repo publishes),
its git path, where its conf.py lives, its published URL, and its
current maturity status.
Note
Authoritative source: ~/.local/share/docs-system/repos.conf.
The machine-readable repos.conf file is the single source of
truth. The tables on this page are currently hand-transcribed from
that file. A Phase 3 tooling item will auto-render these tables
from repos.conf at Sphinx build time. Until that ships, when you
add or change a repo, update repos.conf first and then mirror
the change here in the same commit.
Tier 1 — Standalone Repos
Each Tier 1 repo is its own Sphinx site, served by a dedicated
container in ~/docker/local-websites/docker-compose.yml and
cross-linked to the others via sphinx.ext.intersphinx.
Repo |
Slug |
Git Path |
|
Published URL |
Status |
Notes |
|---|---|---|---|---|---|---|
Documentation_System |
|
|
|
healthy |
Canonical methodology spec; Phase 1 buildout in progress. |
|
Linux |
|
|
root |
healthy |
41 sections; only repo with a pre-existing CLAUDE.md. |
|
DevOps-Docs |
|
|
|
healthy |
Includes Project-Doc-Automation section. |
|
Artificial-Intelligence |
|
|
|
healthy |
Active but early; WIP notice on index. |
|
Server_Programs |
|
|
root |
healthy |
89 documented programs; largest Tier 1 content body. |
|
Accounting |
|
|
|
(not yet deployed) |
stub |
Awaiting content; Phase 5 backlog ingestion will populate. |
Entrepreneurship |
|
|
|
(not yet deployed) |
stub |
Awaiting content; Phase 5 backlog ingestion will populate. |
Tier 2 — Aggregation Hubs
A Tier 2 hub is a Sphinx site that mounts other projects’ docs/
directories via Docker volumes and builds a unified index across them.
Hubs have their own slug and label namespace but their content is
sourced from the mounted projects.
Hub |
Slug |
Git Path |
|
Published URL |
Status |
|---|---|---|---|---|---|
docker-infrastructure-docs |
|
|
|
healthy |
Adding, Renaming, or Retiring a Repo
All three operations touch the same two files: repos.conf (the
authoritative source) and this page (the rendered mirror). Until the
Phase 3 auto-render lands, update both in the same commit.
Add a repo. Append a line to the correct tier block in
repos.conf, then add a matching row to the corresponding table on this page. Full end-to-end scaffold instructions for a new Tier 1 repo (includingconf.py, intersphinx wiring, router entry, and the first deploy) live inworkflows/new-repo.rst(forthcoming).Rename a slug. Renames cascade across every label in the repo plus every
:ref:caller in every other repo. Do not attempt without the workflow atworkflows/label-migration.rst(forthcoming).Retire a repo. Move the line from its tier block down to a
# --- Retired ---block at the bottom ofrepos.conf, change status toretired, and strike the row from this page.
Planned Repos
This registry tracks only repos that exist on disk today. Planned-
but-not-yet-created repos are not listed here; they appear as worked
examples in workflows/new-repo.rst (forthcoming) and move into
this registry only once they are scaffolded and serving.