mirror of https://github.com/apache/cassandra
c7b9401bf8
* doc_in_tree: Modify build file to include html doc in artifacts Add 'report bug' section Fix minor errors in CQL doc Finish fixing the CQL doc Don't track auto-generated file Reorganize document Automatically generate docs for cassandra.yaml Fix CQL doc (incomplete) Add Metrics/Monitoring docs Add Change Data Capture documentation Docs for Memtable and SSTable architecture Add doc on compaction Add initial version of security section Fill in Replication, Tuneable Consistency sections Add docs for cqlsh Add snitch and range movements section on Operations Add initial in-tree documentation (very incomplete so far) |
||
|---|---|---|
| .. | ||
| cql3 | ||
| source | ||
| Makefile | ||
| README.md | ||
| SASI.md | ||
| convert_yaml_to_rst.py | ||
| make.bat | ||
| native_protocol_v3.spec | ||
| native_protocol_v4.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/subdirectory. See below for more details on how to edit/build that documentation. - The specification(s) for the supported versions of native transport protocol.
- Additional documentation on the SASI implementation (
SASI.md). TODO: we should probably move the first half of that documentation to the general documentation, and the implementation explanation parts into the wiki.
Official documentation
The source for the official documentation for Apache Cassandra can be found in
the source subdirectory. The documentation uses sphinx
and is thus written in reStructuredText.
To build the HTML documentation, you will need to first install sphinx and the [sphinx ReadTheDocs theme](the https://pypi.python.org/pypi/sphinx_rtd_theme), which on unix you can do with:
pip install sphinx sphinx_rtd_theme
The documentation can then be built from this directory by calling make html
(or make.bat html on windows). Alternatively, the top-level ant gen-doc
target can be used.