[prev in list] [next in list] [prev in thread] [next in thread] 

List:       cassandra-dev
Subject:    Re: [DISCUSS] Updating the C* website design
From:       Rahul Singh <rahul.xavier.singh () gmail ! com>
Date:       2020-08-22 1:44:25
Message-ID: 9d0915b0-6b9c-49aa-a425-f1f756c4b85d () Spark
[Download RAW message or body]


Seems like even Antora uses another SSG called middleman for their "marketing" home \
page.

https://gitlab.com/antora/antora.org

If the convenience of having both content and docs all in one SSG for code \
maintenance is compatible with the aesthetic/ content / taxonomy strategy need for \
the site visitors, we'll find out soon enough.




rahul.xavier.singh@gmail.com

http://cassandra.link
The Apache Cassandra Knowledge Base.
On Aug 21, 2020, 8:54 PM -0400, Rahul Singh , wrote:
> 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.singh@gmail.com
> 
> http://cassandra.link
> The Apache Cassandra Knowledge Base.
> On Jul 29, 2020, 1:28 PM -0400, M Brandon Williams <driftx@gmail.com>, wrote:
> > 
> > web



[prev in list] [next in list] [prev in thread] [next in thread]