Mailing-List: contact dev-help@community.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@community.apache.org
Received-SPF: pass (nike.apache.org: domain of rgardler@opendirective.com
 designates 209.85.215.170 as permitted sender)
MIME-Version: 1.0
In-Reply-To: 
 <CAEWfVJ=tS3U6J=QsQkGStSUcbK4RqNP6gsOUcRrZ66MeW-gf0w@mail.gmail.com>
References: <4ECE877F.7010106@shanecurcuru.org>
 <CAEWfVJ=tS3U6J=QsQkGStSUcbK4RqNP6gsOUcRrZ66MeW-gf0w@mail.gmail.com>
From: Ross Gardler <rgardler@opendirective.com>
Date: Fri, 25 Nov 2011 13:43:45 +0000
Message-ID: 
 <CAKQbXgB=2bsiRadDPN2PbRGAV2UptYuoQH81x5dUstWeriQwZQ@mail.gmail.com>
Subject: Re: Website improvement ideas
To: dev@community.apache.org
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

On 25 November 2011 09:42, Bertrand Delacretaz <bdelacretaz@apache.org> wro=
te:
> Hi Shane,
>
> On Thu, Nov 24, 2011 at 7:05 PM, Shane Curcuru <asf@shanecurcuru.org> wro=
te:
>> With my shiny new PMC hat (thanks!) I've started thinking about some use=
ful
>> organization and presentation for the community.a.o pages. =A0Shout if y=
ou
>> have suggested changes, or if I should not do any of these things someda=
y...
>
> 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 comm=
ent.

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


--=20
Ross Gardler (@rgardler)
Programme Leader (Open Development)
OpenDirective http://opendirective.com