This directory contains the documentation maintained in-tree for Apache Cassandra. This directory contains the following documents:
source/
subdirectory. See below for more details on how to edit/build that documentation.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.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.