The original second sentence implied per-table scope, which contradicted the first sentence. Replaced with explicit keyspace-scope wording and removed the redundant vector/non-vector qualifier. |
||
|---|---|---|
| .. | ||
| cql3 | ||
| modules | ||
| scripts | ||
| Makefile | ||
| README.md | ||
| SASI.md | ||
| native_protocol_v3.spec | ||
| native_protocol_v4.spec | ||
| native_protocol_v5.spec | ||
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/modulessubdirectory. 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 version.
To generate the asciidoc files (including antora.yml) for cassandra.yaml and the nodetool commands, run (from project root):
ant gen-asciidoc
or (from this directory):
make gen-asciidoc
(The following has not yet been implemented, for now see the build instructions in the cassandra-website repo.) To build the documentation, run (from project root):
ant gen-doc
or (from this directory):
make html