beads/website/sidebars.ts
matt wilkie b2a4d1d04a
docs: generate CLI reference from live help (#3704)
* docs: generate CLI reference from live help

* docs(cli): move bd version stamp from per-command pages to index only

Drops the `(bd version X.Y.Z)` suffix from the auto-generated header on
every per-command CLI reference page (writeSingleCommandDoc) and the
docs/CLI_REFERENCE.md preamble (writeAllHelp). The version label now
lives only on the index page emitted by scripts/generate-cli-docs.sh:

- Dev tree (website/docs/cli-reference/index.md, docs/CLI_REFERENCE.md):
  labelled "Latest"
- Versioned snapshots (website/versioned_docs/version-X.Y.Z/...):
  labelled with the explicit semver tag parsed from the directory name

This eliminates the 100+-file no-signal diff a release version bump
otherwise produces, restoring the "regen as a separate small commit"
workflow PR #3704 enables. After this change a version bump alone
yields zero diff on the dev tree; only the new versioned snapshot
created at release-cut time carries the new tag. No datestamps are
introduced anywhere — scripts/generate-cli-docs.sh --check remains
deterministic across CI runs.

Refs: mybd-afb, PR #3704

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: CI Bot <ci@beads.test>
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-05 19:43:49 -07:00

109 lines
2.3 KiB
TypeScript

import type {SidebarsConfig} from '@docusaurus/plugin-content-docs';
const sidebars: SidebarsConfig = {
docsSidebar: [
'intro',
{
type: 'category',
label: 'Getting Started',
items: [
'getting-started/installation',
'getting-started/quickstart',
'getting-started/ide-setup',
'getting-started/upgrading',
],
},
{
type: 'category',
label: 'Core Concepts',
collapsed: true,
items: [
'core-concepts/index',
'core-concepts/issues',
'core-concepts/hash-ids',
],
},
{
type: 'category',
label: 'Architecture',
collapsed: true,
items: [
'architecture/index',
],
},
{
type: 'category',
label: 'CLI Reference',
collapsed: true,
link: {
type: 'doc',
id: 'cli-reference/index',
},
items: [
{
type: 'autogenerated',
dirName: 'cli-reference',
},
],
},
{
type: 'category',
label: 'Workflows',
collapsed: true,
items: [
'workflows/index',
'workflows/molecules',
'workflows/formulas',
'workflows/gates',
'workflows/wisps',
],
},
{
type: 'category',
label: 'Recovery',
collapsed: true,
items: [
'recovery/index',
'recovery/database-corruption',
'recovery/merge-conflicts',
'recovery/circular-dependencies',
'recovery/sync-failures',
],
},
{
type: 'category',
label: 'Multi-Agent',
collapsed: true,
items: [
'multi-agent/index',
'multi-agent/routing',
'multi-agent/coordination',
],
},
{
type: 'category',
label: 'Integrations',
collapsed: true,
items: [
'integrations/claude-code',
'integrations/mcp-server',
'integrations/aider',
'integrations/junie',
],
},
{
type: 'category',
label: 'Reference',
collapsed: true,
items: [
'reference/configuration',
'reference/git-integration',
'reference/advanced',
'reference/troubleshooting',
'reference/faq',
],
},
],
};
export default sidebars;