Skip to content

fix(docs): pin charter-audit and what-is-straymark anchors#176

Merged
montfort merged 1 commit into
mainfrom
fix/docs-repair-anchors
May 19, 2026
Merged

fix(docs): pin charter-audit and what-is-straymark anchors#176
montfort merged 1 commit into
mainfrom
fix/docs-repair-anchors

Conversation

@montfort
Copy link
Copy Markdown
Contributor

Summary

Two TOC anchors in ADOPTION-GUIDE pointed at slugs Docusaurus didn't generate the way the source assumed:

  • `#what-is-straymark-framework` / `#qué-es-straymark-framework` — the heading slug is shorter, so the TOC link 404'd.
  • `#straymark-charter-audit-charter-id-range-revrev-calibrate--finalize-path-dir` — the heading contains ``, `<REV..REV>`, `` which Docusaurus strips differently than the link anticipated.

Fix by attaching explicit `{#slug}` anchors to the destination headings and rewriting the charter-audit link to the short slug. EN + ES + zh-CN.

Test plan

  • `npm run build` → exit 0, no "Broken anchor" warnings (only pre-existing cross-tree link warnings remain, tracked separately)
  • Manually verify TOC link `¿Qué es StrayMark?` resolves to the heading
  • Manually verify the `straymark charter audit` cross-file link

🤖 Generated with Claude Code

Two anchors in ADOPTION-GUIDE pointed at slugs that Docusaurus didn't
generate the way the source assumed:

- `#what-is-straymark-framework` / `#qué-es-straymark-framework` —
  the heading ("What is StrayMark?" / "¿Qué es StrayMark?") generates
  a shorter slug, so the TOC link 404'd.
- `#straymark-charter-audit-charter-id-range-revrev-calibrate--finalize-path-dir`
  — the heading contains <CHARTER-ID>, <REV..REV>, <PATH> which Docusaurus
  strips in a way the link didn't anticipate.

Fix by attaching explicit `{#slug}` anchors to the destination headings
(stable across heading edits and arg changes) and rewriting the
charter-audit link to the short slug. Applied in EN, ES, and zh-CN.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@montfort montfort merged commit 9be1bb4 into main May 19, 2026
1 check passed
@montfort montfort deleted the fix/docs-repair-anchors branch May 19, 2026 07:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant