Skip to content

Docs: Fix broken internal anchor links#16893

Draft
thswlsqls wants to merge 1 commit into
apache:mainfrom
thswlsqls:docs/fix-broken-internal-anchor-links
Draft

Docs: Fix broken internal anchor links#16893
thswlsqls wants to merge 1 commit into
apache:mainfrom
thswlsqls:docs/fix-broken-internal-anchor-links

Conversation

@thswlsqls

@thswlsqls thswlsqls commented Jun 21, 2026

Copy link
Copy Markdown
Contributor

Summary

Several internal doc links pointed to anchors that do not exist on the target page, so clicking them loaded the page but did not scroll to the section.

  • branching.md: spark-procedures.md#expire-snapshots#expire_snapshots (header ### \expire_snapshots`` keeps the underscore).
  • branching.md, index.md: spark-queries.md#time-travel had no such anchor → #time-travel-queries-with-sql (section ### Time travel Queries with SQL).
  • nessie.md: flink.md#preparation-when-using-flinks-python-api did not exist → #flinks-python-api (section ## Flink's Python API).
  • flink-ddl.md, flink-writes.md: dropped a stray slash in *.md/#anchor links to match every other cross-page link.

Sibling links already use the correct slugs (e.g. spark-structured-streaming.md links spark-procedures.md#expire_snapshots), confirming these are typos.

Testing done

  • Docs-only change, no behavior change — no test added.
  • Verified each updated slug matches exactly one existing target header. The docs build sets no custom slugify, so the default toc slugify keeps underscores and turns spaces into hyphens.

AI Disclosure

  • Model: Claude Opus 4.8
  • Platform/Tool: Claude Code

Several internal doc links pointed to anchors that do not exist on the
target pages, so clicking them loaded the page but did not jump to the
section.

- branching.md, index.md: spark-procedures/spark-queries anchors did not
  match the actual header slugs (#expire_snapshots, time-travel section).
- nessie.md: flink.md Python API anchor did not exist.
- flink-ddl.md, flink-writes.md: dropped the stray slash in
  ".md/#anchor" links so they match every other cross-page link.

Sibling links already use the correct slugs (e.g.
spark-structured-streaming.md links #expire_snapshots).

Generated-by: Claude Code
@github-actions github-actions Bot added the docs label Jun 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant