Folks,

I applaud the choice of Antora for documentation but I’m not sure it is the 
best choice for generating an appealing site.

Antora’s self professed strength is in technical documentation. Do we want to 
stick to a “documentation” / utility look for the front facing site or for a 
blog?

https://gitlab.com/antora/antora/-/issues/444

I don’t want to rehash any conclusion on choosing Antora for docs or whether 
asciidoc is the choice for writing documentation.

Could we think about using something like Gatsby or similar for the front 
facing 5-10 pages + blog ? E. G. Skywalking uses vuepress.

We can use asciidoc as the common format while using Antora for the docs and 
something else for the rest of the content 
(https://www.gatsbyjs.com/plugins/gatsby-transformer-asciidoc/)

Something like Gatsby can use both Markdown and Asciidoc and we can migrate 
from one to the other while still using the same tooling.

Just some thoughts would love feedback!

rahul.xavier.si...@gmail.com

http://cassandra.link
The Apache Cassandra Knowledge Base.
On Jul 29, 2020, 1:28 PM -0400, M Brandon Williams <dri...@gmail.com>, wrote:
>
> web

Reply via email to