Agreed. This is an awesome POC in a pretty short period of time. I suspect with a little polish and cleanup this will be an improvement over the existing site in every way.
Thanks for putting this together, Lorina! On Thu, Jun 11, 2020 at 7:36 AM Joshua McKenzie <jmcken...@apache.org> wrote: > 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) > > >
