I agree as well. Nice work, Lorina! This POC is a really good start. It has a bit more of a modern feel to it. The navigation bar on the side makes the information very accessible. This is a must for technical documentation.
Would it be possible to have a search bar somewhere on the site? I think this would be useful to allow a user to navigate quickly to something they know they are after e.g. a nodetool command or configuration setting. Kind regards, On Fri, 12 Jun 2020 at 02:02, Jon Haddad <j...@jonhaddad.com> wrote: > 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) > > > > > >
