1de171b910983628e1b7e19dbeac0a3bb09dbab0 | Author: Anthony Grasso <anthony@thelastpickle.com>
| 2022-04-02 15:41:01+11:00
move and prepare files for content folder
* Added logic to move generated website and in-tree docs to content folder
* Added logic to remove hardcoded and missing domains from links
* Added logging functionality
patch by Anthony Grasso; reviewed by Michael Semb Wever for CASSANDRA-17374
65033abc8747d060b45a958bd52be399a9cb9987 | Author: Diogenese Topper <diotopper@gmail.com>
| 2021-12-23 19:14:21-08:00
December blog post titled: "Configurable Storage Ports and Why We Need Them"
patch by Chris Thornett, Diogenese Topper; reviewed by Anthony Grasso, Erick Ramirez for CASSANDRA-1722
217b35b4f26b5d71388926d09b526d53b8fecf01 | Author: mck <mck@apache.org>
| 2021-12-23 23:42:12+01:00
Just do `ant gen-asciidoc`, as all cassandra sources that have antora/asciidocs have gen-nodetool-docs.py and convert_yaml_to_adoc.py
patch by Mick Semb Wever; reviewed by Anthony Grasso for CASSANDRA-16763
05b0eaecad5e40390352a4e182179a29ac784372 | Author: Lorina Poland <lorinapoland@gmail.com>
| 2021-06-28 10:19:46-07:00
Migrate documentation to AsciiDoc
This commit sets up a new documentation structure and format:
* The directory struture changes from a Sphinx project to an Antora module layout.
* The formatting of the content changes from reStructuredText to AsciiDoc.
The documentation must now be built and published with Antora. Initially only from the cassandra-website repository.
This change was done to make maintaining versioned website documentation easier. As Antora is designed to generate versioned documentation.
The old directory structure was:
<ROOT>
- doc/
- cql3/
- CQL.css
- CQL.textile
- source/
- _static/
- _templates/
- _theme/
- _util/
- <other directory sections>/
- conf.py
- index.rst
- <other *.rst pages>
- make.bat
- Makefile
- README.md
- SASI.md
- <*.spec files>
- <generation scripts>
The new directory structure organises the documentation into modules:
<ROOT>
- doc/
- cql3
- modules/
- cassandra/
- assets/
- examples/
- pages/
- partials/
- nav.adoc
- ROOT/
- pages/
- nav.adoc
- scripts/
- antora.yaml
- README.md
- SASI.md
patch by Lorina Poland, Anthony Grasso; reviewed by Anthony Grasso, Mick Semb Wever for CASSANDRA-16763
Co-authored-by: Anthony Grasso <anthony@thelastpickle.com>