The 113-page generated CLI Reference moves from a top-level nav group to a nested group inside Reference — Mintlify renders nested groups collapsed by default, so the command list no longer dominates the sidebar. The docsmint nav splice is depth-agnostic (indentation is derived from the pages key's line), verified by regenerating and by re-pointing its test fixture at the nested shape. Reference overview and the beads-docs skill IA note updated.
1.6 KiB
1.6 KiB
| title | description |
|---|---|
| Reference | Lookup material — configuration, git integration, JSON contracts, observability, troubleshooting, and the FAQ. |
Lookup material for beads: the pages here specify contracts and edge cases rather than teach concepts (that's How Beads Works).
Pages in this section
- Configuration — every config key, environment variable, default, and the precedence between them.
- Git Integration — hooks,
refs/dolt/data, role detection, and branchless (jujutsu) workflows. - Git Worktrees Guide — how beads behaves across worktrees sharing one repository.
- Protected Branches — sync-branch mode for repos where direct pushes to main are blocked.
- Advanced Features — rename, merge, compaction, and other power-user operations.
- JSON Output Schema Contract — the stability
contract behind every
--jsonflag. - Observability (OpenTelemetry) — traces and metrics bd can emit, and how to point them at a collector.
- Troubleshooting — symptom-first fixes for common failures (deeper runbooks live in Recovery).
- Antivirus False Positives — Windows AV heuristics and binary verification.
- FAQ — beads vs other trackers, and the questions everyone asks in week one.
- CLI Reference — the generated page-per-command reference, nested below as a collapsible group.