ACK, ACK, you're both right.
The Apache Governance stuff fits in with my idea of ComDev providing
background "why" information in a much simpler to read format. Then the
actual policies and the "How" and "Who" details are in the usual places
under /dev.
The issue for me is that /dev, even with improvements in the past two
years, is still a wild and wolly forest of unorganized stuff. I
sometimes try to figure out a way to organize one page, but then realize
you can't touch any of the headers because some other random page links
to them directly, and I wish I had a month to sit with an actual Editor
and just completely reorganize the site (along with cleaning some of the
remaining incorrect/outdated info).
So better explaining /dev, and especially catching old or confusingly
worded (for a normal human) parts of /dev would be great to work on as
well, if folks have time.
- Shane, rambling a bit
On 2011-11-25 8:43 AM, Ross Gardler wrote:
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
