community-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Shane Curcuru <...@shanecurcuru.org>
Subject Re: Website improvement ideas
Date Fri, 25 Nov 2011 14:34:30 GMT
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<bdelacretaz@apache.org>  wrote:
>> Hi Shane,
>>
>> On Thu, Nov 24, 2011 at 7:05 PM, Shane Curcuru<asf@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
>
>

Mime
View raw message