System docs
Architecture · classification · changelog
You are here: ZajLibrary → System docs
This shelf is for you if: you need to know where content belongs or how the library itself is governed.
Not this shelf? Resources → Reference = how to write pages (voice, components, plugins).
The map
Section titled “The map”Where does new content go?
Start here
Section titled “Start here” Content architecture Shelves, types, taxonomy layers, file-vs-folder rules.
Decision tree Classify one new item without overthinking.
Content types Canonical names, synonyms, when to use each.
Changelog Site and plugin changes.
AI writing contract Agent checklist digest — verify against AGENTS.md if stale.
Sections in this shelf
Section titled “Sections in this shelf”| Section | Holds |
|---|---|
| Authoring & agents | Agent read order, intake, links to digests |
| Templates | Skeleton map + template → live example |
| Worked examples | Reference-quality pages by doc type |
| Visuals & diagrams | Warrant test, component inventory, when to create SVG |
| Content architecture | Shelves, decision tree, taxonomy, shape rules |
| Collections, categories, tags | Metadata without folder sprawl |
| File vs folder | One page or a hub of pages |
| Changelog | What changed in the site |
| Starlight plugins in use | Digest — verify against astro.config.mjs |
| AI writing contract | Agent checklist — verify against AGENTS.md |
Authoring groups (folder map)
Section titled “Authoring groups (folder map)” Authoring Agents, intake, read order
Templates Copy-paste spines + example map
Examples Live pages to imitate
Visuals Diagrams + warrant test
Content architecture IA & classification
Understand everything — system docs vs reference
System docs = rules about the library (IA, classification, changelog). Reference = how to author pages (Starlight components, writing style, diagram gallery). Agents should read AGENTS.md + reference shelf first; system docs are optional digests when fresh.