natas_hw
/
cassandra
mirror of https://github.com/apache/cassandra
0
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
cassandra/doc
History
Patrick McFadin fc8883fc70 CASSANDRA-21342: Fix broken Antora xref/anchor targets in cassandra docs 
Resolve broken cross-module xrefs and image/anchor targets across the
cassandra docs tree. Companion to apache/cassandra-website#319 (merged
2026-05-13) under the same JIRA umbrella.

Forward-merge of trunk commit 32826fe563 to cassandra-6.0, which was
omitted from the 2026-05-14 forward-merge of this fix to the release
branches. Two hunks in create-custom-index.adoc were already present
via the CASSANDRA-21342 long-tail forward-merge; one additional
unqualified collection-create xref in the same file (not present on
trunk at the time of the original patch) is fixed here. All retargeted
anchors verified present on cassandra-6.0, including
list-superusers-statement (absent on 5.0, present here).

 patch by Patrick McFadin; reviewed by Brandon Williams for CASSANDRA-21342
 		2026-06-10 11:54:15 -07:00
..
cql3 Implementation of CEP-55 - Generation of role names 2025-10-23 13:53:56 +02:00
modules CASSANDRA-21342: Fix broken Antora xref/anchor targets in cassandra docs 2026-06-10 11:54:15 -07:00
scripts Merge branch 'cassandra-5.0' into cassandra-6.0 2026-06-08 21:54:28 +02:00
Makefile Merge branch 'cassandra-5.0' into cassandra-6.0 2026-06-08 21:54:28 +02:00
README.md Generation of in-tree html and manpages documentation 2026-04-10 19:36:50 +02:00
SASI.md CASSANDRA-20117: fixed typos in NTR spec and SASI documents 2025-04-03 13:59:05 -04:00
native_protocol_v3.spec CASSANDRA-20117: fixed typos in NTR spec and SASI documents 2025-04-03 13:59:05 -04:00
native_protocol_v4.spec CASSANDRA-20117: fixed typos in NTR spec and SASI documents 2025-04-03 13:59:05 -04:00
native_protocol_v5.spec CASSANDRA-13342: Document failure reason codes in native protocol v5 spec 2026-04-10 15:24:04 -07:00
site-local.yml Generation of in-tree html and manpages documentation 2026-04-10 19:36:50 +02:00

README.md

Apache Cassandra documentation directory

This directory contains the documentation maintained in-tree for Apache Cassandra. This directory contains the following documents:

  • The source of the official Cassandra documentation, in the source/modules subdirectory. See below for more details on how to edit/build that documentation.
  • The specification(s) for the supported versions of native transport protocol.

Official documentation

The source for the official documentation for Apache Cassandra can be found in the modules/cassandra/pages subdirectory. The documentation uses antora and is thus written in asciidoc.

The antora.yml file is auto-generated and should not be manually edited. It is generated from the version in build.xml using scripts/gen-antora-yml.py and automatically detects whether building from a release tag or branch HEAD to set the appropriate full or short version.

The antora.yml and some of the asciidoc files are dynamically generated using ant gen-asciidoc.

Building HTML Pages

To build the HTML documentation for this version only, you have two options:

Option 1: Using globally installed Antora (requires Node.js, Antora and Pandoc installed):

ant gen-doc

This uses the site-local.yml antora playbook to build only the current in-tree version.

Option 2: Using Docker:

.build/docker/build-docs.sh

This uses the same Docker image as cassandra-website, with all tooling pre-installed.

The HTML will be generated in build/html/.

For building documentation across multiple Cassandra versions, see the build instructions in the cassandra-website repo.

Building Man Pages

Building the html documentation also generates a manpages file.

View the man page:

man ../build/man/cassandra-docs.7.gz

Note: This creates a single comprehensive reference manual (section 7) containing all documentation.