From a3b5fe2f9b2016a289d55f94d3c4ca15007104c5 Mon Sep 17 00:00:00 2001 From: Patrick McFadin Date: Fri, 24 Apr 2026 13:51:24 -0700 Subject: [PATCH 1/2] Fix 11 Antora broken-xref / level-0 errors in cassandra-website content Resolves five distinct fix classes in the asf-staging source tree: - blog/Apache-Cassandra-4.0-Overview.adoc: xref target extension .html -> .adoc so Antora resolves the AsciiDoc source instead of a rendered URL. - blog/Configurable-Storage-Ports-and-Why-We-Need-Them.adoc: remove a duplicate document title line that triggered a level-0 section error. - blog/Even-Higher-Availability-with-5x-Faster-Streaming-in-Cassandra-4.adoc: update xref from removed faster_streaming_in_cassandra.adoc to current Hardware-bound-Zero-Copy-Streaming-in-Apache-Cassandra-4.adoc. - development/gettingstarted.adoc, development/ide.adoc: replace malformed xref:: (double colon) with xref:development/... so the target resolves. - development/index.adoc: add leveloffset=+1 to all include:: directives so included pages' = document titles render as sub-sections rather than firing level-0 errors. Verified locally against both pre- and post-fix builds via site-content/bin/xref-report.sh --baseline: fixed 11, introduced 0. Remaining 9 errors in the local build (missing images, partials, and a few path rewrites) are separate fix classes and will follow. patch by Patrick McFadin; reviewed by TBD for CASSANDRA-21342 --- .../blog/Apache-Cassandra-4.0-Overview.adoc | 2 +- ...le-Storage-Ports-and-Why-We-Need-Them.adoc | 2 -- ...th-5x-Faster-Streaming-in-Cassandra-4.adoc | 2 +- .../pages/development/gettingstarted.adoc | 2 +- .../modules/ROOT/pages/development/ide.adoc | 2 +- .../modules/ROOT/pages/development/index.adoc | 22 +++++++++---------- 6 files changed, 15 insertions(+), 17 deletions(-) diff --git a/site-content/source/modules/ROOT/pages/blog/Apache-Cassandra-4.0-Overview.adoc b/site-content/source/modules/ROOT/pages/blog/Apache-Cassandra-4.0-Overview.adoc index 6788938089..929bb693e3 100644 --- a/site-content/source/modules/ROOT/pages/blog/Apache-Cassandra-4.0-Overview.adoc +++ b/site-content/source/modules/ROOT/pages/blog/Apache-Cassandra-4.0-Overview.adoc @@ -21,7 +21,7 @@ Testing included purpose-built new tools to cover every requirement: * Fault injection * Unit / dtest coverage expansion -Those xref:blog/Testing-Apache-Cassandra-4.html[tools] were perfected and deployed to help meet quality goals and set a baseline for any future version of Cassandra. They provide needed infrastructure to ensure future releases retain the highest levels of quality and correctness. +Those xref:blog/Testing-Apache-Cassandra-4.adoc[tools] were perfected and deployed to help meet quality goals and set a baseline for any future version of Cassandra. They provide needed infrastructure to ensure future releases retain the highest levels of quality and correctness. So, what can you expect from Cassandra 4.0? diff --git a/site-content/source/modules/ROOT/pages/blog/Configurable-Storage-Ports-and-Why-We-Need-Them.adoc b/site-content/source/modules/ROOT/pages/blog/Configurable-Storage-Ports-and-Why-We-Need-Them.adoc index 05215fea24..e2c9bded2f 100644 --- a/site-content/source/modules/ROOT/pages/blog/Configurable-Storage-Ports-and-Why-We-Need-Them.adoc +++ b/site-content/source/modules/ROOT/pages/blog/Configurable-Storage-Ports-and-Why-We-Need-Them.adoc @@ -6,8 +6,6 @@ :description: The Apache Cassandra Community :keywords: -= Configurable Storage Ports and Why We Need Them - image::blog/configurable-storage-ports-and-why-we-need-them-unsplash-bernard-hermant.jpg[storage ports] Image credit: https://unsplash.com/@bernardhermant?utm_source=unsplash&utm_medium=referral&utm_content=creditCopyText[Bernard Hermant on Unsplash,window=_blank] diff --git a/site-content/source/modules/ROOT/pages/blog/Even-Higher-Availability-with-5x-Faster-Streaming-in-Cassandra-4.adoc b/site-content/source/modules/ROOT/pages/blog/Even-Higher-Availability-with-5x-Faster-Streaming-in-Cassandra-4.adoc index 155a5ebdc4..6f6769859b 100644 --- a/site-content/source/modules/ROOT/pages/blog/Even-Higher-Availability-with-5x-Faster-Streaming-in-Cassandra-4.adoc +++ b/site-content/source/modules/ROOT/pages/blog/Even-Higher-Availability-with-5x-Faster-Streaming-in-Cassandra-4.adoc @@ -16,7 +16,7 @@ As part of this replacement operation, the new Cassandra node streams data from == Increasing Availability -To minimize the failure window, we want to make these operations as fast as possible. The faster the new node completes streaming its data, the faster it can serve traffic, increasing the availability of the cluster. Towards this goal, Cassandra 4.0 saw the addition of https://en.wikipedia.org/wiki/Zero-copy[Zero Copy,window=_blank] streaming. For more details on Cassandra’s zero copy implementation, see this xref:blog/faster_streaming_in_cassandra.adoc[blog post,window=_blank] and https://issues.apache.org/jira/browse/CASSANDRA-14556[CASSANDRA-14556,window=_blank] for more information. +To minimize the failure window, we want to make these operations as fast as possible. The faster the new node completes streaming its data, the faster it can serve traffic, increasing the availability of the cluster. Towards this goal, Cassandra 4.0 saw the addition of https://en.wikipedia.org/wiki/Zero-copy[Zero Copy,window=_blank] streaming. For more details on Cassandra’s zero copy implementation, see this xref:blog/Hardware-bound-Zero-Copy-Streaming-in-Apache-Cassandra-4.adoc[blog post,window=_blank] and https://issues.apache.org/jira/browse/CASSANDRA-14556[CASSANDRA-14556,window=_blank] for more information. == Talking Numbers diff --git a/site-content/source/modules/ROOT/pages/development/gettingstarted.adoc b/site-content/source/modules/ROOT/pages/development/gettingstarted.adoc index b38baeb208..c5cd571ea8 100644 --- a/site-content/source/modules/ROOT/pages/development/gettingstarted.adoc +++ b/site-content/source/modules/ROOT/pages/development/gettingstarted.adoc @@ -56,7 +56,7 @@ reliably reproduce an issue can be a massive contribution. Document your method of reproduction in a JIRA comment or, better yet, produce an automated test that reproduces the issue and attach it to the ticket. -If you go as far as producing a fix, follow the process for submitting a xref::patches.adoc[patch]. +If you go as far as producing a fix, follow the process for submitting a xref:development/patches.adoc[patch]. To create a JIRA account, please request it on xref:community.adoc#discussions[the #cassandra or #cassandra-dev channels on ASF Slack], or on xref:community.adoc#discussions[the user or dev mailing list]. diff --git a/site-content/source/modules/ROOT/pages/development/ide.adoc b/site-content/source/modules/ROOT/pages/development/ide.adoc index 1f4dced9ff..1d740b560e 100644 --- a/site-content/source/modules/ROOT/pages/development/ide.adoc +++ b/site-content/source/modules/ROOT/pages/development/ide.adoc @@ -189,7 +189,7 @@ Tests can be debugged by defining breakpoints (double-click line number) and selecting `Debug As > JUnit Test`. Alternatively all unit tests can be run from the command line as -described in xref::testing.adoc[testing]. +described in xref:development/testing.adoc[testing]. ==== Debugging Cassandra Using Eclipse diff --git a/site-content/source/modules/ROOT/pages/development/index.adoc b/site-content/source/modules/ROOT/pages/development/index.adoc index defa012516..7d1664e13c 100644 --- a/site-content/source/modules/ROOT/pages/development/index.adoc +++ b/site-content/source/modules/ROOT/pages/development/index.adoc @@ -13,24 +13,24 @@ * xref:development/documentation.adoc[Documentation] * xref:development/release_process.adoc[Release process] -include::page$development/gettingstarted.adoc[] +include::page$development/gettingstarted.adoc[leveloffset=+1] -include::page$development/ide.adoc[] +include::page$development/ide.adoc[leveloffset=+1] -include::page$development/testing.adoc[] +include::page$development/testing.adoc[leveloffset=+1] -include::page$development/code_style.adoc[] +include::page$development/code_style.adoc[leveloffset=+1] -include::page$development/how_to_commit.adoc[] +include::page$development/how_to_commit.adoc[leveloffset=+1] -include::page$development/how_to_review.adoc[] +include::page$development/how_to_review.adoc[leveloffset=+1] -include::page$development/patches.adoc[] +include::page$development/patches.adoc[leveloffset=+1] -include::page$development/ci.adoc[] +include::page$development/ci.adoc[leveloffset=+1] -include::page$development/dependencies.adoc[] +include::page$development/dependencies.adoc[leveloffset=+1] -include::page$development/documentation.adoc[Documentation] +include::page$development/documentation.adoc[leveloffset=+1] -include::page$development/release_process.adoc[] +include::page$development/release_process.adoc[leveloffset=+1] From 22b83fdfa31348ecee42c1e231371d3141b4b4b7 Mon Sep 17 00:00:00 2001 From: Patrick McFadin Date: Fri, 24 Apr 2026 14:09:32 -0700 Subject: [PATCH 2/2] Fix remaining Antora errors in cassandra-website content Second batch of broken-xref / broken-asset fixes on the asf-staging source tree: - blog/Apache-Cassandra-Changelog-{19-September,20-November}-2022.adoc: replace rendered-site xref target doc/latest/cassandra/architecture/ overview.adoc with the Antora component-qualified form Cassandra:cassandra:architecture/overview.adoc. - blog/Apache-Cassandra-Changelog-20-November-2022.adoc: remove a space that had crept into the xref target for the Cassandra-Day-SC-Bellevue- Houston-WakandaForever.adoc file. - glossary.adoc: remove three include directives that referenced partials never present in this repo (persistent-volume, persistent-volume-claim, segment). - download.adoc: rewrite image target from absolute rendered URL /assets/img/caution.svg to the Antora-relative form caution.svg (the asset lives in modules/ROOT/images/). - apachecon_cfp.adoc: remove reference to /img/apachecon-2019.jpg, an asset that was lost during the 2020 Jekyll-to-Antora migration (CASSANDRA-16066). Surrounding 2019 archival prose stays intact. Local verification via xref-report.sh delta against the post-batch-1 build: 8 of 9 targeted errors demonstrably resolved (total went from 9 to 3). Remaining 3 errors (2 from the architecture/overview rewrites, 1 from the main-nav Cassandra::index.adoc reference) all depend on the Cassandra component being present in the Antora build. The local verification build was a minimal website-only run (no -g flag) that does not import the Cassandra component, so these three cannot be validated locally; the Jenkins build resolves the Cassandra component from multiple version sources and is the authoritative test for them. The main-nav Cassandra::index.adoc xref was NOT touched in this commit. Root cause analysis shows cassandra/doc/antora.yml declares the 6.0 version as prerelease, which disqualifies it as the default target for unversioned xrefs. Fix direction (un-prerelease, pin a version, or re-point the nav) is production-config-sensitive and left for a separate ticket. patch by Patrick McFadin; reviewed by TBD for CASSANDRA-21342 --- site-content/source/modules/ROOT/pages/apachecon_cfp.adoc | 3 --- .../blog/Apache-Cassandra-Changelog-19-September-2022.adoc | 2 +- .../blog/Apache-Cassandra-Changelog-20-November-2022.adoc | 4 ++-- site-content/source/modules/ROOT/pages/download.adoc | 2 +- site-content/source/modules/ROOT/pages/glossary.adoc | 6 ------ 5 files changed, 4 insertions(+), 13 deletions(-) diff --git a/site-content/source/modules/ROOT/pages/apachecon_cfp.adoc b/site-content/source/modules/ROOT/pages/apachecon_cfp.adoc index 678c1443f4..d825d12dcc 100644 --- a/site-content/source/modules/ROOT/pages/apachecon_cfp.adoc +++ b/site-content/source/modules/ROOT/pages/apachecon_cfp.adoc @@ -12,9 +12,6 @@ Summit, hosted with ApacheCon in Las Vegas, NV (Sept 9 - 13). === Apache Cassandra at ApacheCon -image:/img/apachecon-2019.jpg[ApacheCon 2019]\{:style=``float: right; -width: 400px''} - For more information about other events at ApacheCon, see https://apachecon.com/acna19/index.html[ApacheCon 2019]. diff --git a/site-content/source/modules/ROOT/pages/blog/Apache-Cassandra-Changelog-19-September-2022.adoc b/site-content/source/modules/ROOT/pages/blog/Apache-Cassandra-Changelog-19-September-2022.adoc index 8a6a020a13..00ad9cb8e2 100644 --- a/site-content/source/modules/ROOT/pages/blog/Apache-Cassandra-Changelog-19-September-2022.adoc +++ b/site-content/source/modules/ROOT/pages/blog/Apache-Cassandra-Changelog-19-September-2022.adoc @@ -37,7 +37,7 @@ To stay up-to-date, we recommend joining the xref:community.adoc#discussions[Cas _Updates on Cassandra Enhancement Proposals (CEPs), how to contribute, and other community activities._ -_For newcomers to the project, we have a useful xref:development/index.adoc[‘Contributing to Cassandra’] page for how to get involved and get started. We would also recommend reading the xref:doc/latest/cassandra/architecture/overview.adoc[overview of the C* architecture^]._ +_For newcomers to the project, we have a useful xref:development/index.adoc[‘Contributing to Cassandra’] page for how to get involved and get started. We would also recommend reading the xref:Cassandra:cassandra:architecture/overview.adoc[overview of the C* architecture^]._ _We use Jira to record project issues. Here’s a handy Jira tip from *Josh McKenzie*: if you want to search for tickets in your area of interest, use this https://issues.apache.org/jira/issues/?jql=project%20%3D%20cassandra%20AND%20resolution%20!%3D%20unresolved%20AND%20assignee%20is%20EMPTY%20AND%20summary%20~%20%27ReplaceTextHere%27%20ORDER%20BY%20priority%20ASC[URL link^]. Simply swap out ‘ReplaceTextHere’ in the URL query string for what you want to find._ diff --git a/site-content/source/modules/ROOT/pages/blog/Apache-Cassandra-Changelog-20-November-2022.adoc b/site-content/source/modules/ROOT/pages/blog/Apache-Cassandra-Changelog-20-November-2022.adoc index 96876464da..eec671bcb8 100644 --- a/site-content/source/modules/ROOT/pages/blog/Apache-Cassandra-Changelog-20-November-2022.adoc +++ b/site-content/source/modules/ROOT/pages/blog/Apache-Cassandra-Changelog-20-November-2022.adoc @@ -35,7 +35,7 @@ To stay up-to-date, we recommend joining the xref:community.adoc#discussions[Ca _Updates on Cassandra Enhancement Proposals (CEPs), how to contribute, and other community activities._ -_For newcomers to the project, we have a useful xref:development/index.adoc[‘Contributing to Cassandra’] page for how to get involved and get started. We would also recommend reading the xref:doc/latest/cassandra/architecture/overview.adoc[overview of the C* architecture]._ +_For newcomers to the project, we have a useful xref:development/index.adoc[‘Contributing to Cassandra’] page for how to get involved and get started. We would also recommend reading the xref:Cassandra:cassandra:architecture/overview.adoc[overview of the C* architecture]._ We use Jira to record project issues. Here’s a handy Jira tip from *Josh McKenzie*, if you want to search for tickets in your area of interest, use this https://issues.apache.org/jira/issues/?jql=project%20%3D%20cassandra%20AND%20resolution%20!%3D%20unresolved%20AND%20assignee%20is%20EMPTY%20AND%20summary%20~%20%27ReplaceTextHere%27%20ORDER%20BY%20priority%20ASC[URL link^]. Simply swap out ‘ReplaceTextHere’ in the URL query string for what you want to find. @@ -147,7 +147,7 @@ video::ZbJrFy4TlNI[youtube,640,360] xref:blog/Cassandra-Days-Asia-2022.adoc[Cassandra Days Asia - Hanoi, Jakarta, Singapore] - Erick Ramirez -xref:blog/Cassandra-Day-SC-Bellevue-Houston-Wakanda Forever.adoc[Cassandra Day Santa Clara-Bellevue-Houston + Wakanda Forever] - Erick Ramirez +xref:blog/Cassandra-Day-SC-Bellevue-Houston-WakandaForever.adoc[Cassandra Day Santa Clara-Bellevue-Houston + Wakanda Forever] - Erick Ramirez xref:blog/Cassandra-Summit-Returns-in-2023.adoc[Cassandra Summit Returns in 2023] - Cassandra Community diff --git a/site-content/source/modules/ROOT/pages/download.adoc b/site-content/source/modules/ROOT/pages/download.adoc index 099ca7f5c7..f6bf8b0ec4 100644 --- a/site-content/source/modules/ROOT/pages/download.adoc +++ b/site-content/source/modules/ROOT/pages/download.adoc @@ -182,7 +182,7 @@ https://repo.maven.apache.org/maven2/org/apache/cassandra/[Maven Central,window= [CAUTION] ==== -image:/assets/img/caution.svg[alt="Caution",width=64,height=64] Debian and RedHat package repositories have moved! +image:caution.svg[alt="Caution",width=64,height=64] Debian and RedHat package repositories have moved! Debian's `sources.list` and RedHat's `cassandra.repo` files must be updated to point to the new repository URLs (see below). ==== diff --git a/site-content/source/modules/ROOT/pages/glossary.adoc b/site-content/source/modules/ROOT/pages/glossary.adoc index 8e91f947ab..99ecee3dd3 100644 --- a/site-content/source/modules/ROOT/pages/glossary.adoc +++ b/site-content/source/modules/ROOT/pages/glossary.adoc @@ -251,10 +251,6 @@ include::ROOT:partial$partition-summary.adoc[] include::ROOT:partial$partitioner.adoc[] -include::ROOT:partial$persistent-volume.adoc[] - -include::ROOT:partial$persistent-volume-claim.adoc[] - include::ROOT:partial$primary-key.adoc[] :leveloffset: -2 @@ -295,8 +291,6 @@ include::ROOT:partial$alphabet-nav.adoc[] include::ROOT:partial$seed.adoc[] -include::ROOT:partial$segment.adoc[] - include::ROOT:partial$serializable-consistency.adoc[] include::ROOT:partial$stcs.adoc[]