You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@thrift.apache.org by Roger Meier <ro...@bufferoverflow.ch> on 2011/11/23 22:23:22 UTC
Thrift Web Site
Hi all
I played a bit around with Apache Forrest and it might be an option to use
it for a new Thrift Web Site.
The homegrown static page generator CMS we have today is difficult to
handle, so we get not that much contributions on documentation.
Apache Forrest provides good formats to manage content and export it into
several formats.
Here's a first example http://people.apache.org/~roger/thrift/
What do you think?
Should I proceed with this?
Is this an option to get better documentation?
Merge Wiki, White Paper, etc. into a Forrest based Web Site?
-roger
AW: Thrift Web Site
Posted by Roger Meier <ro...@bufferoverflow.ch>.
+1 for Jake's approach
I propose to remove current site and use that one created by Jake
http://people.apache.org/~jfarrell/
Using symbolic link from site and source tree might help to keep
e.g. README files within tutorial section in sync with the web site
-roger
> -----Ursprüngliche Nachricht-----
> Von: Diwaker Gupta [mailto:diwaker@maginatics.com]
> Gesendet: Montag, 28. November 2011 03:01
>
>
> +1 for Jekyll or Hyde (http://hyde.github.com/)
>
> Diwaker
>
> On Fri, Nov 25, 2011 at 5:10 AM, Roger Meier
> <ro...@bufferoverflow.ch>wrote:
>
> > Yes, markdown syntax is much better as this xml stuff used by Apache
> > Forrest!
> >
> > Markdown is just great, let's go for such an approach!
> >
> > What we need is:
> > - better documentation
> > - simple & fast
> > - contributors can send their patches easily
> > - edit with every editor
> > - close to the source repo
> >
> > One approach might be to rename existing README files within source
> > tree to README.md and replace the LICENSE header with a reference.
> >
> > Hyde or Jekyll, I don't know... I prefer minimal dependencies and just
> > a few easy to manage config files.
> >
> > -roger
> >
> >
> > > -----Ursprüngliche Nachricht-----
> > > Von: Jake Farrell [mailto:jfarrell@apache.org]
> > > Gesendet: Freitag, 25. November 2011 00:12
> > > An: dev@thrift.apache.org
> > > Betreff: Re: Thrift Web Site
> > >
> > > I took a quick look at Jekyll last night and was able to convert the
> > existing site
> > > over to markdown and get it up and running pretty quickly. I think
> > > using something like Jekyll or Hyde with markdown content would be
> > > beneficial because it would simplify the process for adding new
> > > tutorials and other items. The CMS looks like it will be a good
> > > option for static pages that
> > are not
> > > in flux, but with our tutorials and other content needing so much
> > > work keeping the site in source control and getting patches from the
> > > community will allow for us to quickly generate content. Forest is
> > > great, but the
> > setup,
> > > configuration and xdoc format is a little more than we currently need.
> > > Keeping it simple so people can easily submit back new pages will
> > > help
> > get
> > > our site to where is should be. Here is the jekyll sample I threw
> > together
> > if
> > > anyone would like to take a look, css needs some cleaning up but
> > > overall concept is there
> > >
> > > - Jake
> > >
> > > Site: http://people.apache.org/~jfarrell/
> > > Source: http://people.apache.org/~jfarrell/jekyll/
> > >
> > >
> > >
> > >
> > >
> > > On Nov 23, 2011, at 8:31 PM, Jake Farrell wrote:
> > >
> > > > I'm taking a looking to the CMS right now to see what it has to
> > > > offer, if we go down the road of a site generator I think looking
> > > > at something like jekyll would be a good idea. Using a backend of
> > > > simple markdown file and the addition of syntax highlighting via
> > > > pygments and its current use for github pages it should be easy
> > > > for people to use and add content to
> > > >
> > > > -Jake
> > > >
> > > >
> > > > ________________________________________
> > > > From: Joe Schaefer [joe_schaefer@yahoo.com]
> > > > Sent: Wednesday, November 23, 2011 4:05 PM
> > > > To: dev@thrift.apache.org
> > > > Subject: Re: Thrift Web Site
> > > >
> > > > I'll still throw in my 2 cents for you guys to use the CMS.
> > > > We don't currently support Forrest sites, but a guinea pig willing
> > > > to sort that out would be appreciated.
> > > >
> > > > In any case I'll get you guys on svnpubsub if you decide to still
> > > > not use the ASF CMS. It's important to infra to get you off rsync
> > > > at some point.
> > > >
> > > >
> > > >
> > > > ----- Original Message -----
> > > >> From: Bryan Duxbury <br...@rapleaf.com>
> > > >> To: dev@thrift.apache.org
> > > >> Cc:
> > > >> Sent: Wednesday, November 23, 2011 5:02 PM
> > > >> Subject: Re: Thrift Web Site
> > > >>
> > > >> Sounds like a worthy effort to continue.
> > > >>
> > > >> On Wed, Nov 23, 2011 at 1:23 PM, Roger Meier
> > > >> <ro...@bufferoverflow.ch>wrote:
> > > >>
> > > >>> Hi all
> > > >>>
> > > >>> I played a bit around with Apache Forrest and it might be an
> > > >>> option to use it for a new Thrift Web Site.
> > > >>> The homegrown static page generator CMS we have today is
> > > >>> difficult to handle, so we get not that much contributions on
> documentation.
> > > >>> Apache Forrest provides good formats to manage content and
> > > >>> export it into several formats.
> > > >>>
> > > >>> Here's a first example http://people.apache.org/~roger/thrift/
> > > >>>
> > > >>> What do you think?
> > > >>> Should I proceed with this?
> > > >>> Is this an option to get better documentation?
> > > >>> Merge Wiki, White Paper, etc. into a Forrest based Web Site?
> > > >>>
> > > >>> -roger
> > > >>>
> > > >>>
> > > >>
> > >
> > >
> >
> >
> >
>
>
> --
> http://maginatics.com
Re: Thrift Web Site
Posted by Diwaker Gupta <di...@maginatics.com>.
+1 for Jekyll or Hyde (http://hyde.github.com/)
Diwaker
On Fri, Nov 25, 2011 at 5:10 AM, Roger Meier <ro...@bufferoverflow.ch>wrote:
> Yes, markdown syntax is much better as this xml stuff used by Apache
> Forrest!
>
> Markdown is just great, let's go for such an approach!
>
> What we need is:
> - better documentation
> - simple & fast
> - contributors can send their patches easily
> - edit with every editor
> - close to the source repo
>
> One approach might be to rename existing README files within source tree to
> README.md and replace the LICENSE header with a reference.
>
> Hyde or Jekyll, I don't know... I prefer minimal dependencies and just a
> few
> easy to manage config files.
>
> -roger
>
>
> > -----Ursprüngliche Nachricht-----
> > Von: Jake Farrell [mailto:jfarrell@apache.org]
> > Gesendet: Freitag, 25. November 2011 00:12
> > An: dev@thrift.apache.org
> > Betreff: Re: Thrift Web Site
> >
> > I took a quick look at Jekyll last night and was able to convert the
> existing site
> > over to markdown and get it up and running pretty quickly. I think using
> > something like Jekyll or Hyde with markdown content would be beneficial
> > because it would simplify the process for adding new tutorials and other
> > items. The CMS looks like it will be a good option for static pages that
> are not
> > in flux, but with our tutorials and other content needing so much work
> > keeping the site in source control and getting patches from the community
> > will allow for us to quickly generate content. Forest is great, but the
> setup,
> > configuration and xdoc format is a little more than we currently need.
> > Keeping it simple so people can easily submit back new pages will help
> get
> > our site to where is should be. Here is the jekyll sample I threw
> together
> if
> > anyone would like to take a look, css needs some cleaning up but overall
> > concept is there
> >
> > - Jake
> >
> > Site: http://people.apache.org/~jfarrell/
> > Source: http://people.apache.org/~jfarrell/jekyll/
> >
> >
> >
> >
> >
> > On Nov 23, 2011, at 8:31 PM, Jake Farrell wrote:
> >
> > > I'm taking a looking to the CMS right now to see what it has to offer,
> > > if we go down the road of a site generator I think looking at
> > > something like jekyll would be a good idea. Using a backend of simple
> > > markdown file and the addition of syntax highlighting via pygments and
> > > its current use for github pages it should be easy for people to use
> > > and add content to
> > >
> > > -Jake
> > >
> > >
> > > ________________________________________
> > > From: Joe Schaefer [joe_schaefer@yahoo.com]
> > > Sent: Wednesday, November 23, 2011 4:05 PM
> > > To: dev@thrift.apache.org
> > > Subject: Re: Thrift Web Site
> > >
> > > I'll still throw in my 2 cents for you guys to use the CMS.
> > > We don't currently support Forrest sites, but a guinea pig willing to
> > > sort that out would be appreciated.
> > >
> > > In any case I'll get you guys on svnpubsub if you decide to still not
> > > use the ASF CMS. It's important to infra to get you off rsync at some
> > > point.
> > >
> > >
> > >
> > > ----- Original Message -----
> > >> From: Bryan Duxbury <br...@rapleaf.com>
> > >> To: dev@thrift.apache.org
> > >> Cc:
> > >> Sent: Wednesday, November 23, 2011 5:02 PM
> > >> Subject: Re: Thrift Web Site
> > >>
> > >> Sounds like a worthy effort to continue.
> > >>
> > >> On Wed, Nov 23, 2011 at 1:23 PM, Roger Meier
> > >> <ro...@bufferoverflow.ch>wrote:
> > >>
> > >>> Hi all
> > >>>
> > >>> I played a bit around with Apache Forrest and it might be an option
> > >>> to use it for a new Thrift Web Site.
> > >>> The homegrown static page generator CMS we have today is difficult
> > >>> to handle, so we get not that much contributions on documentation.
> > >>> Apache Forrest provides good formats to manage content and export it
> > >>> into several formats.
> > >>>
> > >>> Here's a first example http://people.apache.org/~roger/thrift/
> > >>>
> > >>> What do you think?
> > >>> Should I proceed with this?
> > >>> Is this an option to get better documentation?
> > >>> Merge Wiki, White Paper, etc. into a Forrest based Web Site?
> > >>>
> > >>> -roger
> > >>>
> > >>>
> > >>
> >
> >
>
>
>
--
http://maginatics.com
AW: Thrift Web Site
Posted by Roger Meier <ro...@bufferoverflow.ch>.
Yes, markdown syntax is much better as this xml stuff used by Apache
Forrest!
Markdown is just great, let's go for such an approach!
What we need is:
- better documentation
- simple & fast
- contributors can send their patches easily
- edit with every editor
- close to the source repo
One approach might be to rename existing README files within source tree to
README.md and replace the LICENSE header with a reference.
Hyde or Jekyll, I don't know... I prefer minimal dependencies and just a few
easy to manage config files.
-roger
> -----Ursprüngliche Nachricht-----
> Von: Jake Farrell [mailto:jfarrell@apache.org]
> Gesendet: Freitag, 25. November 2011 00:12
> An: dev@thrift.apache.org
> Betreff: Re: Thrift Web Site
>
> I took a quick look at Jekyll last night and was able to convert the
existing site
> over to markdown and get it up and running pretty quickly. I think using
> something like Jekyll or Hyde with markdown content would be beneficial
> because it would simplify the process for adding new tutorials and other
> items. The CMS looks like it will be a good option for static pages that
are not
> in flux, but with our tutorials and other content needing so much work
> keeping the site in source control and getting patches from the community
> will allow for us to quickly generate content. Forest is great, but the
setup,
> configuration and xdoc format is a little more than we currently need.
> Keeping it simple so people can easily submit back new pages will help get
> our site to where is should be. Here is the jekyll sample I threw together
if
> anyone would like to take a look, css needs some cleaning up but overall
> concept is there
>
> - Jake
>
> Site: http://people.apache.org/~jfarrell/
> Source: http://people.apache.org/~jfarrell/jekyll/
>
>
>
>
>
> On Nov 23, 2011, at 8:31 PM, Jake Farrell wrote:
>
> > I'm taking a looking to the CMS right now to see what it has to offer,
> > if we go down the road of a site generator I think looking at
> > something like jekyll would be a good idea. Using a backend of simple
> > markdown file and the addition of syntax highlighting via pygments and
> > its current use for github pages it should be easy for people to use
> > and add content to
> >
> > -Jake
> >
> >
> > ________________________________________
> > From: Joe Schaefer [joe_schaefer@yahoo.com]
> > Sent: Wednesday, November 23, 2011 4:05 PM
> > To: dev@thrift.apache.org
> > Subject: Re: Thrift Web Site
> >
> > I'll still throw in my 2 cents for you guys to use the CMS.
> > We don't currently support Forrest sites, but a guinea pig willing to
> > sort that out would be appreciated.
> >
> > In any case I'll get you guys on svnpubsub if you decide to still not
> > use the ASF CMS. It's important to infra to get you off rsync at some
> > point.
> >
> >
> >
> > ----- Original Message -----
> >> From: Bryan Duxbury <br...@rapleaf.com>
> >> To: dev@thrift.apache.org
> >> Cc:
> >> Sent: Wednesday, November 23, 2011 5:02 PM
> >> Subject: Re: Thrift Web Site
> >>
> >> Sounds like a worthy effort to continue.
> >>
> >> On Wed, Nov 23, 2011 at 1:23 PM, Roger Meier
> >> <ro...@bufferoverflow.ch>wrote:
> >>
> >>> Hi all
> >>>
> >>> I played a bit around with Apache Forrest and it might be an option
> >>> to use it for a new Thrift Web Site.
> >>> The homegrown static page generator CMS we have today is difficult
> >>> to handle, so we get not that much contributions on documentation.
> >>> Apache Forrest provides good formats to manage content and export it
> >>> into several formats.
> >>>
> >>> Here's a first example http://people.apache.org/~roger/thrift/
> >>>
> >>> What do you think?
> >>> Should I proceed with this?
> >>> Is this an option to get better documentation?
> >>> Merge Wiki, White Paper, etc. into a Forrest based Web Site?
> >>>
> >>> -roger
> >>>
> >>>
> >>
>
>
Re: Thrift Web Site
Posted by Jake Farrell <jf...@apache.org>.
I took a quick look at Jekyll last night and was able to convert the existing site over to markdown and get it up and running pretty quickly. I think using something like Jekyll or Hyde with markdown content would be beneficial because it would simplify the process for adding new tutorials and other items. The CMS looks like it will be a good option for static pages that are not in flux, but with our tutorials and other content needing so much work keeping the site in source control and getting patches from the community will allow for us to quickly generate content. Forest is great, but the setup, configuration and xdoc format is a little more than we currently need. Keeping it simple so people can easily submit back new pages will help get our site to where is should be. Here is the jekyll sample I threw together if anyone would like to take a look, css needs some cleaning up but overall concept is there
- Jake
Site: http://people.apache.org/~jfarrell/
Source: http://people.apache.org/~jfarrell/jekyll/
On Nov 23, 2011, at 8:31 PM, Jake Farrell wrote:
> I'm taking a looking to the CMS right now to see what it has to offer, if we go down the road of a site generator I think looking at something like jekyll would be a good idea. Using a backend of simple markdown file and the addition of syntax highlighting via pygments and its current use for github pages it should be easy for people to use and add content to
>
> -Jake
>
>
> ________________________________________
> From: Joe Schaefer [joe_schaefer@yahoo.com]
> Sent: Wednesday, November 23, 2011 4:05 PM
> To: dev@thrift.apache.org
> Subject: Re: Thrift Web Site
>
> I'll still throw in my 2 cents for you guys to use the CMS.
> We don't currently support Forrest sites, but a guinea pig
> willing to sort that out would be appreciated.
>
> In any case I'll get you guys on svnpubsub if you decide to
> still not use the ASF CMS. It's important to infra to get
> you off rsync at some point.
>
>
>
> ----- Original Message -----
>> From: Bryan Duxbury <br...@rapleaf.com>
>> To: dev@thrift.apache.org
>> Cc:
>> Sent: Wednesday, November 23, 2011 5:02 PM
>> Subject: Re: Thrift Web Site
>>
>> Sounds like a worthy effort to continue.
>>
>> On Wed, Nov 23, 2011 at 1:23 PM, Roger Meier
>> <ro...@bufferoverflow.ch>wrote:
>>
>>> Hi all
>>>
>>> I played a bit around with Apache Forrest and it might be an option to use
>>> it for a new Thrift Web Site.
>>> The homegrown static page generator CMS we have today is difficult to
>>> handle, so we get not that much contributions on documentation.
>>> Apache Forrest provides good formats to manage content and export it into
>>> several formats.
>>>
>>> Here's a first example http://people.apache.org/~roger/thrift/
>>>
>>> What do you think?
>>> Should I proceed with this?
>>> Is this an option to get better documentation?
>>> Merge Wiki, White Paper, etc. into a Forrest based Web Site?
>>>
>>> -roger
>>>
>>>
>>
RE: Thrift Web Site
Posted by Jake Farrell <JF...@onesite.com>.
I'm taking a looking to the CMS right now to see what it has to offer, if we go down the road of a site generator I think looking at something like jekyll would be a good idea. Using a backend of simple markdown file and the addition of syntax highlighting via pygments and its current use for github pages it should be easy for people to use and add content to
-Jake
________________________________________
From: Joe Schaefer [joe_schaefer@yahoo.com]
Sent: Wednesday, November 23, 2011 4:05 PM
To: dev@thrift.apache.org
Subject: Re: Thrift Web Site
I'll still throw in my 2 cents for you guys to use the CMS.
We don't currently support Forrest sites, but a guinea pig
willing to sort that out would be appreciated.
In any case I'll get you guys on svnpubsub if you decide to
still not use the ASF CMS. It's important to infra to get
you off rsync at some point.
----- Original Message -----
> From: Bryan Duxbury <br...@rapleaf.com>
> To: dev@thrift.apache.org
> Cc:
> Sent: Wednesday, November 23, 2011 5:02 PM
> Subject: Re: Thrift Web Site
>
> Sounds like a worthy effort to continue.
>
> On Wed, Nov 23, 2011 at 1:23 PM, Roger Meier
> <ro...@bufferoverflow.ch>wrote:
>
>> Hi all
>>
>> I played a bit around with Apache Forrest and it might be an option to use
>> it for a new Thrift Web Site.
>> The homegrown static page generator CMS we have today is difficult to
>> handle, so we get not that much contributions on documentation.
>> Apache Forrest provides good formats to manage content and export it into
>> several formats.
>>
>> Here's a first example http://people.apache.org/~roger/thrift/
>>
>> What do you think?
>> Should I proceed with this?
>> Is this an option to get better documentation?
>> Merge Wiki, White Paper, etc. into a Forrest based Web Site?
>>
>> -roger
>>
>>
>
Re: Thrift Web Site
Posted by Joe Schaefer <jo...@yahoo.com>.
I'll still throw in my 2 cents for you guys to use the CMS.
We don't currently support Forrest sites, but a guinea pig
willing to sort that out would be appreciated.
In any case I'll get you guys on svnpubsub if you decide to
still not use the ASF CMS. It's important to infra to get
you off rsync at some point.
----- Original Message -----
> From: Bryan Duxbury <br...@rapleaf.com>
> To: dev@thrift.apache.org
> Cc:
> Sent: Wednesday, November 23, 2011 5:02 PM
> Subject: Re: Thrift Web Site
>
> Sounds like a worthy effort to continue.
>
> On Wed, Nov 23, 2011 at 1:23 PM, Roger Meier
> <ro...@bufferoverflow.ch>wrote:
>
>> Hi all
>>
>> I played a bit around with Apache Forrest and it might be an option to use
>> it for a new Thrift Web Site.
>> The homegrown static page generator CMS we have today is difficult to
>> handle, so we get not that much contributions on documentation.
>> Apache Forrest provides good formats to manage content and export it into
>> several formats.
>>
>> Here's a first example http://people.apache.org/~roger/thrift/
>>
>> What do you think?
>> Should I proceed with this?
>> Is this an option to get better documentation?
>> Merge Wiki, White Paper, etc. into a Forrest based Web Site?
>>
>> -roger
>>
>>
>
Re: Thrift Web Site
Posted by Bryan Duxbury <br...@rapleaf.com>.
Sounds like a worthy effort to continue.
On Wed, Nov 23, 2011 at 1:23 PM, Roger Meier <ro...@bufferoverflow.ch>wrote:
> Hi all
>
> I played a bit around with Apache Forrest and it might be an option to use
> it for a new Thrift Web Site.
> The homegrown static page generator CMS we have today is difficult to
> handle, so we get not that much contributions on documentation.
> Apache Forrest provides good formats to manage content and export it into
> several formats.
>
> Here's a first example http://people.apache.org/~roger/thrift/
>
> What do you think?
> Should I proceed with this?
> Is this an option to get better documentation?
> Merge Wiki, White Paper, etc. into a Forrest based Web Site?
>
> -roger
>
>