pmcfadin opened a new pull request, #4810: URL: https://github.com/apache/cassandra/pull/4810
## Summary Follow-up to PR #4807 (merged 2026-05-14). Closes the long-tail of broken xref errors that remained on `trunk` after the umbrella patch landed. Six per-fix-class commits during review (per @driftx's request to squash on +1). All changes are mechanical retargets; no prose was rewritten and no pages were added or removed. Anchors that did not exist are added with the project's existing `[[anchor]]` convention. ## Per-commit scope | Commit | Class | Files | Sites | |---|---|---:|---:| | `920a506` | Module-prefix xrefs (bare/partial paths -> `cassandra:`-qualified) | 9 | 11 | | `9c6d9f7` | Moved-page xrefs (page renamed/relocated; retarget to current home) | 9 | 11 | | `55e6df4` | Filename typo (`defintions.adoc` -> `definitions.adoc`) | 1 | 1 | | `dec49ce` | `.html` -> `.adoc` and retarget writetime to `functions.adoc` | 2 | 2 | | `6aa9589` | Qualify nodetool xrefs to `cassandra:managing/tools/nodetool/` (generated targets) | 3 | 4 | | `cac55a5` | Add missing anchors and retarget anchored xrefs | 7 | 7 + 3 anchor adds | Each commit body details the individual xref edits. ## Verification For every still-existing anchor target, the target page and explicit `[[anchor]]` (or auto-generated section id) were grep-verified on `upstream/trunk` before the edit. The triage was driven by the 2026-04-22 Antora 3 baseline (Jenkins #2752); patterns where no source-file on `trunk` still references the old target were treated as already-closed and not touched. ## Not included About ten additional broken xrefs require content decisions and are deferred to a separate workstream alongside the `master@_:ROOT:bugs.adoc` / `contactus.adoc` decision (Accord index stub, compression-options retarget, `_2i-*` partial-prefix resolution, the `cyclist_*-table.adoc` example references, drop-materialized-view stub, the `_/download.adoc` cross-component xref). They are mechanically distinct: they need either a new page, an external link, or a prose rewrite — not a retarget. ## Generated-page caveat The four `nodetool` xrefs in commit `6aa9589` point at generated pages that `gen-asciidoc` emits at Antora build time, so they cannot be grep-verified from a static checkout. The form matches existing `nav.adoc` xrefs (e.g. `cassandra:managing/tools/nodetool/nodetool.adoc`) that have shipped without complaint. If any do not resolve at the next build, will fix in a follow-up. ## Forward-merge `cassandra-5.0`, `cassandra-4.1`, and `cassandra-4.0` will receive applicable subsets after merge here, following the same convention as PR #4807's forward-merges (committer push, no per-branch PR). Pattern-presence will be re-checked per branch. ## AI disclosure Drafting and triage were performed with AI assistance (Anthropic Claude). The change set is reviewable as straightforward xref retargets and anchor additions. Source provenance per ASF generative tooling guidance. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
