This is an automated email from the ASF dual-hosted git repository.

pmcfadin pushed a commit to branch trunk
in repository https://gitbox.apache.org/repos/asf/cassandra-website.git

commit 574a61fc11e1948f4e3ce956139bb07e6a374137
Author: Patrick McFadin <[email protected]>
AuthorDate: Fri Apr 24 13:51:24 2026 -0700

    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 Brandon Williams for CASSANDRA-21342
---
 .../pages/blog/Apache-Cassandra-4.0-Overview.adoc  |  2 +-
 ...gurable-Storage-Ports-and-Why-We-Need-Them.adoc |  2 --
 ...ty-with-5x-Faster-Streaming-in-Cassandra-4.adoc |  2 +-
 .../ROOT/pages/development/gettingstarted.adoc     |  2 +-
 .../source/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 67889380..929bb693 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 05215fea..e2c9bded 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 155a5ebd..6f676985 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 
[...]
+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 po 
[...]
 
 == 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 b38baeb2..c5cd571e 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 1f4dced9..1d740b56 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 defa0125..7d1664e1 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]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to