Decisions

Index

ADR	Status	Notes
2026-05-08 Docs System	Accepted	Reader model, taxonomy, start-here navigation, glossary, compatibility matrix, and docs verification layer.

ADR 2026-05-08: Docs System Upgrade

Status: Accepted · Date: 2026-05-08

Context

Sidekick's docs scheme kept the repository organized, but readers still needed a clearer path from role or task to the right document. The docs also needed a canonical glossary, compatibility matrix, and durable place for docs-system decisions.

Decision

Keep site/doc-scheme.md as the placement contract, then add a reader-first layer:

• Start Here for task-first navigation.
• Audience for reader roles and entry points.
• Glossary for canonical terms.
• Compatibility for host and sidekick differences.
• This decisions page for durable docs-system choices.

The public Help section remains the task-oriented surface and links back to these docs.

Consequences

• New readers have a single page that tells them where to begin.
• Canonical terms stop drifting across docs.
• Runtime differences are visible in one place.
• Important docs decisions have a stable home separate from knowledge notes.

Format

Each ADR should answer: what problem are we solving, what decision did we make, what alternatives did we reject, and what are the consequences. Keep ADRs short, dated, and specific.