Agreed the navigation is nicer. The content rst conversion is however far from perfect, especially in the CQL parts. The grammar parts are all broken, most tables are really weird (example: https://polandll.github.io/site/ASCIIDOC_POC/4.0/cassandra/cql/types.html) and we lost almost all linking in those parts.
I think that's up to pandoc not handling rst too well, and while that could be fixed manually, it's going to be some work. So I'd suggest giving a shot at https://pypi.org/project/sphinx-asciidoc/ as an alternative. I haven't tested it, but it supposedly exists to be a better converter than pandoc and it may save some of that manual work. -- Sylvain On Thu, Jun 11, 2020 at 4:45 PM Ekaterina Dimitrova <e.dimitr...@gmail.com> wrote: > I told the same to Lorina in person, +1 more fan > > On Thu, 11 Jun 2020 at 10:36, 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) > > > > > >
