beads/internal
matt wilkie 57a4cab9f0
docs: fix broken xref to docs/EXTENDING.md in extension example (#3713)
* docs: fix broken xref to docs/EXTENDING.md in extension example

The extension example README referenced docs/EXTENDING.md in three
places, but that file was deliberately deleted in the SQLite -> Dolt
migration (see CHANGELOG entry "Deleted deprecated docs - removed
EXTENDING.md and MULTI_REPO_HYDRATION.md (SQLite-era, no longer
applicable)"). Anyone following the example hits a broken link.

Removed all three references. The example README is itself the
canonical reference for the extension pattern, so no redirect target
is needed.

Note: other docs in the repo still reference the deleted EXTENDING.md
(docs/ADVANCED.md, docs/CONFIG.md, examples/library-usage/README.md,
website/docs/reference/advanced.md). Those are out of scope for this
fix and should be addressed in follow-up issues.

Tracking bead: mybd-q71
GH: #3683
PR: builds on follow-up audit from PR #3706

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

* docs: fix remaining broken xrefs to deleted EXTENDING.md across repo

Round 1 (commit ddeff314c) only fixed the extension example README
because the original prompt scoped that PR narrowly. The bead
(mybd-q71) acceptance is repo-wide ("no broken xrefs anywhere"), so
this follow-up sweeps the rest in the same PR per the project's
"one issue per PR" rule.

Per-file treatment (EXTENDING.md was deleted in commit 508387377
before v1.0.0 was tagged, so even the v1.0.0 versioned snapshot has
been broken since release):

- docs/ADVANCED.md (3 refs):
  * Note in Extensible Database section: drop trailing "See
    EXTENDING.md for details" — the surrounding sentence about
    Dolt-era alternatives stands on its own.
  * Bold "See EXTENDING.md for complete documentation" line:
    redirect to the canonical working example
    (examples/bd-example-extension-go).
  * Next Steps bullet: same redirect.
- docs/CONFIG.md (2 refs):
  * Namespace doc for compact_*: replace "(see EXTENDING.md)" with
    "(used by `bd admin compact`)" — the doc itself describes the
    keys, no external reference needed.
  * See Also bullet: replace with link to docs/ADVANCED.md
    (Extensible Database section).
- examples/library-usage/README.md (1 ref):
  * See Also bullet: replace EXTENDING.md link with link to the
    sibling bd-example-extension-go example.
- website/docs/reference/advanced.md (1 ref):
  * Custom Tables section: replace EXTENDING.md link with link to
    the bd-example-extension-go README on GitHub.
- website/versioned_docs/version-1.0.0/reference/advanced.md (1 ref):
  * Same fix as the live docs. EXTENDING.md was deleted before
    v1.0.0 release (commit 508387377 is an ancestor of tag v1.0.0),
    so this versioned snapshot has been broken since cut and a fix
    here doesn't violate frozen-in-time correctness — the link was
    never valid in the v1.0.0 release.
- website/static/llms-full.txt (1 ref, auto-generated artifact):
  * Updated to match the corrected source so the on-disk artifact
    isn't broken until next regeneration.
- beads.go and internal/beads/beads.go (package doc comments):
  * Replaced "see docs/EXTENDING.md" / "see EXTENDING.md" with a
    pointer to examples/bd-example-extension-go. These were real
    broken pointers in published Go source comments.

CHANGELOG.md historical entries left untouched (intentional history).
cmd/bd/info.go:747 left untouched (it's a programmatic CHANGELOG
entry rendered by `bd info`, equivalent to a CHANGELOG line).

Verification:
  grep -rn 'EXTENDING\.md' --include='*.md' .
returns only CHANGELOG.md hits.

Tracking bead: mybd-q71
GH: #3683
PR: #3713 (round 2)

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 13:18:43 -07:00
..
ado fix(ado): use date-only format for WIQL ChangedDate queries (#3345) 2026-04-20 13:05:34 -07:00
atomicfile /internal/atomicfile/atomicfile.go: use io.Copy 2026-05-01 17:03:30 -07:00
audit fix: avoid false shared-server bootstrap no-op for synthesized worktrees 2026-04-24 08:16:38 -07:00
beads docs: fix broken xref to docs/EXTENDING.md in extension example (#3713) 2026-05-05 13:18:43 -07:00
compact fix(ci): get nightly full tests passing (#2835) 2026-03-26 09:52:03 -07:00
config Merge main into OAuth client credentials branch 2026-05-02 19:14:05 -07:00
configfile feat(config): add central server config library (#3258) 2026-04-27 12:54:11 -07:00
debug chore: unexport 14 dead symbols across 8 packages 2026-02-07 09:24:22 -08:00
doltserver [codex] Diagnose Dolt journal corruption and init lock hangs (#3457) 2026-04-24 07:14:24 -07:00
formula fix(release): ship beads-release formula (#3631) 2026-05-02 14:02:36 -07:00
git feat: add --list and --doc flags to bd help for CLI doc generation (GH#2527) 2026-03-11 18:25:40 -07:00
github github: classify rate-limit 403s and stop the push loop when one hits (#3624) 2026-05-02 14:24:57 -07:00
gitlab fix(gitlab): wire issue link dependencies into sync pull (GH#2645) (#3202) 2026-04-11 21:21:49 -07:00
hooks fix: increase TestRun_Async polling timeout to 10s (bd-ldi) 2026-02-28 23:11:46 -08:00
idgen fix(idgen): correct test vectors in hash_test.go 2025-12-19 18:13:56 -08:00
jira fix: support Jira Cloud token pagination (#3456) 2026-04-24 06:58:32 -07:00
linear Sync Linear milestones as local epics (#3528) 2026-05-05 07:45:30 -07:00
lockfile chore: remove daemon infrastructure (lockfile, activity signal) (bd-9u8zd) 2026-02-18 19:05:31 -08:00
molecules /{cmd,internal}: update global store to be interface 2026-03-17 13:26:17 -07:00
notion feat: reimplement Notion sync on REST data sources (fix-merge PR #2759) 2026-03-27 19:20:40 -07:00
query feat(issues): add started_at timestamp (GH#2796) (#3206) 2026-04-14 09:24:08 -07:00
recipes Enforce .beads/ directory permissions at runtime 2026-03-30 09:15:49 -07:00
remotecache fix: don't normalize user-provided sync.remote URLs (GH#3339) (#3432) 2026-04-24 09:33:02 -07:00
routing Fix init leaving beads.role unset in edge cases (GH#2950) (#2964) 2026-04-01 17:00:41 -07:00
storage fix(list): deduplicate issues with multiple blocks dependencies (GH#3567) (#3673) 2026-05-04 11:43:39 -07:00
telemetry /{cmd,internal}: move local only state to dolt ignored tables 2026-04-14 14:47:30 -07:00
templates/agents feat(setup): omit bd dolt push from template when no remote configured 2026-04-27 17:37:42 -04:00
testutil ci: install dolt binary on Linux and macOS test runners (#3440) 2026-04-24 06:58:40 -07:00
timeparsing chore: unexport 14 dead symbols across 8 packages 2026-02-07 09:24:22 -08:00
tracker Sync Linear milestones as local epics (#3528) 2026-05-05 07:45:30 -07:00
types Merge pull request #3646 from kevglynn/fix/list-deferred-complete 2026-05-02 19:04:50 -07:00
ui fix(cli): swap CommandStyle colors for correct light/dark contrast (GH#3611) 2026-05-03 01:46:16 -04:00
utils fix(sort): natural numeric sort for issue IDs with dotted suffixes (GH#3477) (#3486) 2026-04-27 07:04:37 -07:00
validation fix: promote gate to built-in type so formula pour works (#3382) 2026-04-24 05:10:56 -07:00