Apache Cassandra project

This page contains the details of a technical writing project accepted for Google Season of Docs.

Project summary

Open source organization:
Apache Cassandra
Technical writer:
dvohra
Project name:
Apache Cassandra 4.0 Documentation Update, and Resolve TODOs in Documentation
Project length:
Long running (5 months)

Project description

Project consists of two sub-projects as follows:

1. Apache Cassandra 4.0 Documentation Update

Review and update existing Apache Cassandra documentation to ensure that it
is aligned with the forthcoming Apache Cassandra 4.0 release. Our proposed
approach to this would be to first put out a call to the cassandra-dev
mailing list for Cassandra contributors to highlight areas of the document
which are in need of updates. Secondly, we would put together a structured
review of the existing documentation to identify potential gaps. For
example: in the structured review, the technical writer could compare the
Cassandra configuration file documentation
(http://cassandra.apache.org/doc/latest/configuration/cassandra_config_file.html) with the configuration options actually contained in the source
(https://github.com/apache/cassandra/blob/trunk/src/java/org/apache/cassandra/config/Config.java).

2. Resolve TODOs in Apache Cassandra Documentation

The Apache Cassandra documentation contains a number of sections
highlighted as "TODO" (or tasks yet to be completed). These are:

  • Operating Cassandra / Backups
  • Operating Cassandra / Bulk Loading
  • CQL / Data Definitions (limited review points)
  • Data Modelling
  • Dynamo / Gossip, Failure Detection and Token Ring
  • Architecture/Guarantees
  • Operating Cassandra/Hints
  • Architecture/Overview (this is proposed as a separate project)
  • Operating Cassandra/Read Repair
  • Many members of the community have produced material to cover these topics (including public blog posts, Stack Overflow posts, etc). The most productive approach to completing these sections may be to request good references and material from the mailing lists and synthesize into a concise document of the Apache Cassandra documentation set.