On 25 November 2011 09:42, Bertrand Delacretaz <bdelacre...@apache.org> wrote: > Hi Shane, > > On Thu, Nov 24, 2011 at 7:05 PM, Shane Curcuru <a...@shanecurcuru.org> wrote: >> With my shiny new PMC hat (thanks!) I've started thinking about some useful >> organization and presentation for the community.a.o pages. Shout if you >> have suggested changes, or if I should not do any of these things someday... > > I like your suggestions, just one comment: we should avoid duplicating > material that's available elsewhere on apache.org, to avoid confusion. > Either link to existing pages and improve them, or move content from > those pages to community.a.o.
I too like the suggestions. I also agree with the avoiding duplication comment. What I have tried to do so far is provide very simple, very high level guidance into our site. The problem I find with documentation in the ASF is that it is typically spread all over the place, often contradictory and always difficult to read (written by x different authors over x years). I think the goal of the ComDev site should be to have a reasonably consistent tone that signposts other materials spread around the apache.org domain. Ross -- Ross Gardler (@rgardler) Programme Leader (Open Development) OpenDirective http://opendirective.com
