Left bar navigation and content navigation on top right are both aesthetically and usability-wise quite superior IMO (comparing to https://cassandra.apache.org/doc/latest/getting_started/configuring.html).
I'm a fan. On Wed, Jun 10, 2020 at 2:21 PM Lorina Poland <lor...@datastax.com> wrote: > Hello all! > > Based on an earlier discussion about moving the OSS C* docs to > asciidoc, to allow more flexibility in maintaining the docs, I've done > a proof of concept about what it would take to accomplish a > conversion. I converted rSt files to asciidoc files using pandoc, did > some additional editing, and use antora (antora.org) as a static site > generator to build the docs. The result is here: > > https://polandll.github.io/site/ASCIIDOC_POC/4.0/cassandra/getting_started/configuring.html#changing-the-location-of-directoriesThe > editing of the docs is NOT complete, but I completed enough to feel > confident that this process can be accomplished. Some YAML > configuration for antora was required, and I did a minimum of UI > configuration (added color banner, logo). Looking for feedback and > questions anyone may have. > > Thanks, > > Lorina Poland (DataStax tech writer) >