You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@cassandra.apache.org by Melissa Logan <lo...@gmail.com> on 2020/09/30 19:42:45 UTC
Re: [DISCUSS] Updating the C* website design
Hi folks,
As there were no dissenting votes, based on lazy consensus we have moved
forward with the project as outlined in CASSANDRA-16115:
https://issues.apache.org/jira/browse/CASSANDRA-16115
If you need a break from 4.0 debugging, would really love folks’ thoughts
on new design concepts. Elements/colors can be mixed-and-matched. See
designs here (you have to enter email to view, but it is not retained):
https://projects.invisionapp.com/freehand/document/7CLfsYoVb?
Please share which you prefer and any comments here:
https://doodle.com/poll/4yc369baaug5dzw7
Any questions, just let me know. Thanks in advance.
On Fri, Aug 21, 2020 at 6:44 PM Rahul Singh <ra...@gmail.com>
wrote:
> 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 <dr...@gmail.com>,
> wrote:
> > >
> > > web
>
Feedback on new Apache Cassandra project website
Posted by Paulo Motta <pa...@gmail.com>.
Hi all,
I'd like to invite the user community to give feedback on the design
concepts below to a new website for the Apache Cassandra project.
Thanks,
Paulo
---------- Forwarded message ---------
De: Melissa Logan <lo...@gmail.com>
Date: qua., 30 de set. de 2020 às 16:43
Subject: Re: [DISCUSS] Updating the C* website design
To: <de...@cassandra.apache.org>
Hi folks,
As there were no dissenting votes, based on lazy consensus we have moved
forward with the project as outlined in CASSANDRA-16115:
https://issues.apache.org/jira/browse/CASSANDRA-16115
If you need a break from 4.0 debugging, would really love folks’ thoughts
on new design concepts. Elements/colors can be mixed-and-matched. See
designs here (you have to enter email to view, but it is not retained):
https://projects.invisionapp.com/freehand/document/7CLfsYoVb?
Please share which you prefer and any comments here:
https://doodle.com/poll/4yc369baaug5dzw7
Any questions, just let me know. Thanks in advance.
On Fri, Aug 21, 2020 at 6:44 PM Rahul Singh <ra...@gmail.com>
wrote:
> 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 <dr...@gmail.com>,
> wrote:
> > >
> > > web
>
Re: [DISCUSS] Updating the C* website design
Posted by Melissa Logan <lo...@gmail.com>.
Thanks to those who provided input on the new site layout. #3 was the
winner with some additional comments, which we'll work to integrate.
In tandem with the new website design, page content has been updated and/or
created as new. Input would be greatly appreciated.
The content doc, plus next steps for the site, can be found in the Jira
ticket here: https://issues.apache.org/jira/browse/CASSANDRA-16115.
Thanks!
On Wed, Sep 30, 2020 at 12:42 PM Melissa Logan <lo...@gmail.com>
wrote:
> Hi folks,
>
> As there were no dissenting votes, based on lazy consensus we have moved
> forward with the project as outlined in CASSANDRA-16115:
> https://issues.apache.org/jira/browse/CASSANDRA-16115
>
> If you need a break from 4.0 debugging, would really love folks’ thoughts
> on new design concepts. Elements/colors can be mixed-and-matched. See
> designs here (you have to enter email to view, but it is not retained):
> https://projects.invisionapp.com/freehand/document/7CLfsYoVb?
>
> Please share which you prefer and any comments here:
> https://doodle.com/poll/4yc369baaug5dzw7
>
> Any questions, just let me know. Thanks in advance.
>
>
> On Fri, Aug 21, 2020 at 6:44 PM Rahul Singh <ra...@gmail.com>
> wrote:
>
>> 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 <dr...@gmail.com>,
>> wrote:
>> > >
>> > > web
>>
>