Re: [RT] a minimal set of docs for incubator.apache.org

2012-08-08 Thread Marvin Humphrey
On Wed, Aug 8, 2012 at 2:29 AM, Bertrand Delacretaz wrote: > How about starting a new, minimal set of docs that are more > maintainable and understandable? +1 to accepting that the end result of the documentation overhaul may be quite different from what exists now. -1 to starting from scratch

Re: [RT] a minimal set of docs for incubator.apache.org

2012-08-08 Thread Gary Martin
Committing somewhere would be good as otherwise I don't know whether I need to suggest the following (I wasn't sure of the best thread for this to go in anyway): May I suggest that, where appropriate, the documentation is backed up with pointers to examples of existing projects that are

Re: [RT] a minimal set of docs for incubator.apache.org

2012-08-08 Thread Greg Stein
Commit the content. Otherwise, we're just hand-waving. On Aug 8, 2012 5:29 AM, "Bertrand Delacretaz" wrote: > Hi, > > Like others, I'm not too happy with the current > http://incubator.apache.org/ content. > > How about starting a new, minimal set of docs that are more > maintainable and understa

[RT] a minimal set of docs for incubator.apache.org

2012-08-08 Thread Bertrand Delacretaz
Hi, Like others, I'm not too happy with the current http://incubator.apache.org/ content. How about starting a new, minimal set of docs that are more maintainable and understandable? IMO, the following would be sufficient, with one page per topic: 1. What's the Apache Incubator? (homepage) 2. L