docs: surface the orphaned troubleshooting page in site navigation

[gregggreg]

Scope chosen

Deliberately minimal: two files, fixing one verified navigation defect.

• website/sidebars.js — add troubleshooting to the Reference category.
• website/docs/intro.md — extend Next Steps with Budget, Scheduling, CLI Reference, and Troubleshooting links; correct the task count from "20+" to 59.

The defect

website/docs/troubleshooting.md has existed with valid frontmatter but was never listed in sidebars.js. Docusaurus therefore rendered it at /docs/troubleshooting with no sidebar entry and no prev/next links — reachable only if you already knew the URL.

Evidence, from the generated globalData.json before this change: every doc carried "sidebar":"docsSidebar" except troubleshooting, which had no sidebar key at all. After the change it reads 'sidebar': 'docsSidebar' and the Reference category resolves to ['CLI Reference', 'Integrations', 'Troubleshooting'].

Assumptions

• Verified-only claims. Every added link target was confirmed to exist in website/docs/. The task count of 59 was read from internal/tasks/tasks.go (59 Name: entries) and matches the existing claim in website/docs/task-reference.md. Nothing was inferred from convention.
• Minimal scope over volume. Based on origin/main so the diff is exactly the change under review.

Gaps deliberately left unaddressed

A survey found this repo's documentation surface almost entirely claimed by 30 open, unmerged docs: PRs. Rather than add overlapping work, these verified-but-already-covered gaps were skipped:

• README completeness — 12 open PRs touch README.md.
• CLI reference expansion, incl. the full nightshift logs flag table — 11 open PRs touch cli-reference.md; docs: backfill CLI reference, architecture overview, and package doc #227 already adds the complete logs table, docs: backfill missing CLI commands in cli-reference.md #223 the report flags, docs: backfill CLI reference for reports and diagnostics commands #210 the reports/diagnostics section.
• Architecture overview — docs: backfill CLI reference, architecture overview, and package doc #227, docs: backfill missing project documentation #181, docs: backfill CONTRIBUTING, architecture map, and docs-backfill guide #182.
• CONTRIBUTING.md — docs: backfill missing project documentation #181, docs: backfill CONTRIBUTING, architecture map, and docs-backfill guide #182, chore: add a commit message standard with normalizer and linter #212.
• Go doc comments on exported symbols — docs: backfill Go doc comments for exported symbols #214, docs: add package-level godoc to all 11 undocumented Go packages #175, docs: backfill missing package and exported-symbol documentation #187, docs: backfill package documentation #196. An AST sweep of all 22 packages found 0 undocumented exported symbols; the only 46 hits were grouped const members that already carry idiomatic trailing comments.

Disclosure: the one-line sidebars.js fix also appears in #149, #196, and #199. It is included here so this PR stands alone; whichever merges first makes the others a no-op.

Verification

Command	Result
npm run build (website)	[SUCCESS] Generated static files in "build". — no broken-link failures
go build -v ./...	exit 0
go test ./...	all 21 packages ok, 0 failures
pre-commit hook	go vet and go build both passed

Sidebar fix confirmed in the regenerated globalData.json as quoted above.

Nightshift-Task: docs-backfill
Nightshift-Ref: https://github.com/marcus/nightshift