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)
>

Reply via email to