Return-Path: 
 <dev-return-118991-apmail-commons-dev-archive=commons.apache.org@commons.apache.org>
Delivered-To: apmail-commons-dev-archive@www.apache.org
Received: (qmail 40438 invoked from network); 7 Apr 2010 15:01:41 -0000
Received: from unknown (HELO mail.apache.org) (140.211.11.3)
  by 140.211.11.9 with SMTP; 7 Apr 2010 15:01:41 -0000
Received: (qmail 39145 invoked by uid 500); 7 Apr 2010 15:01:41 -0000
Delivered-To: apmail-commons-dev-archive@commons.apache.org
Received: (qmail 39008 invoked by uid 500); 7 Apr 2010 15:01:40 -0000
Mailing-List: contact dev-help@commons.apache.org; run by ezmlm
Precedence: bulk
List-Help: <mailto:dev-help@commons.apache.org>
List-Unsubscribe: <mailto:dev-unsubscribe@commons.apache.org>
List-Post: <mailto:dev@commons.apache.org>
List-Id: <dev.commons.apache.org>
Reply-To: "Commons Developers List" <dev@commons.apache.org>
Delivered-To: mailing list dev@commons.apache.org
Received: (qmail 39000 invoked by uid 99); 7 Apr 2010 15:01:40 -0000
Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136)
    by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 07 Apr 2010 15:01:40 +0000
X-ASF-Spam-Status: No, hits=-0.8 required=10.0
	tests=AWL,FREEMAIL_FROM,RCVD_IN_DNSWL_NONE,SPF_PASS
X-Spam-Check-By: apache.org
Received-SPF: pass (athena.apache.org: domain of rahul.akolkar@gmail.com
 designates 209.85.212.43 as permitted sender)
Received: from [209.85.212.43] (HELO mail-vw0-f43.google.com) (209.85.212.43)
    by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 07 Apr 2010 15:01:34 +0000
Received: by vws18 with SMTP id 18so509007vws.30
        for <dev@commons.apache.org>; Wed, 07 Apr 2010 08:01:13 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=gamma;
        h=domainkey-signature:mime-version:received:in-reply-to:references
         :date:received:message-id:subject:from:to:content-type
         :content-transfer-encoding;
        bh=txMCFDdTQN97F3AwWQjcs6DvvCbmWPmpH9jdo7QSB3Y=;
        b=T4r7nr+aHadrGqs5844nlvGGewGhxskH69jr7OMSJSAEQbScrnJLKY6ZsxhGrSXJer
         AUXm//BOJljsaIe3N6ZiGqn5XuIgjPtLPe/D7DGu7QiAoyhu67FC+/hRsQwFn+kNCIIK
         s77iXTdzZ1wYFUnSk3tVEqa0Q4vrKX48iOJpk=
DomainKey-Signature: a=rsa-sha1; c=nofws;
        d=gmail.com; s=gamma;
        h=mime-version:in-reply-to:references:date:message-id:subject:from:to
         :content-type:content-transfer-encoding;
        b=mNNBznqzgevzaSoDhB2adjHc2lxOPcasO8a+cXpJr75vwlXcSY7SK6e81CHr2E2V1J
         +lTsz54dE1ZEZ0KVh0bYZB4qJITTPTWuF4T+dhvF6cerl9vMJvmll1gM5OQY7/kqXCG4
         3vS+Jm1MTt6v977UpYHVZCpSkOE34+sXOUM10=
MIME-Version: 1.0
Received: by 10.220.170.67 with HTTP; Wed, 7 Apr 2010 08:01:13 -0700 (PDT)
In-Reply-To: <m2g25aac9fc1004070752r7dc3fc55m9c52a90bb4200c0d@mail.gmail.com>
References: <4BB9F252.60809@gmail.com>
	 <y2w25aac9fc1004051354j2221e830o48a97cd41bb9e968@mail.gmail.com>
	 <g2h31cc37361004052137te7fc4853ucdbb389335a69733@mail.gmail.com>
	 <h2ice1f2ea81004070745pab1627e7n31f36b7978c9ad02@mail.gmail.com>
	 <m2g25aac9fc1004070752r7dc3fc55m9c52a90bb4200c0d@mail.gmail.com>
Date: Wed, 7 Apr 2010 12:01:13 -0300
Received: by 10.220.126.140 with SMTP id c12mr4435742vcs.170.1270652473692;
	Wed, 07 Apr 2010 08:01:13 -0700 (PDT)
Message-ID: <j2jce1f2ea81004070801q19babab0w6bc8d955693c76b7@mail.gmail.com>
Subject: Re: [all] Release preparation documentation
From: Rahul Akolkar <rahul.akolkar@gmail.com>
To: Commons Developers List <dev@commons.apache.org>
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

On Wed, Apr 7, 2010 at 11:52 AM, sebb <sebbaz@gmail.com> wrote:
> On 07/04/2010, Rahul Akolkar <rahul.akolkar@gmail.com> wrote:
>> On Tue, Apr 6, 2010 at 1:37 AM, Henri Yandell <flamefew@gmail.com> wrote=
:
>> =A0<snip/>
>>
>> >
>> =A0> I've been deleting desirable goals from the docs :)
>> =A0>
>> =A0> I think it's more desirable that they be short, sweet and focused;
>> =A0> than that they cover all possibilities.
>> =A0>
>>
>> <snap/>
>>
>> =A0Ideally:
>> =A0 * half a screen-full's worth recipe on one webpage, no scrolling
>> =A0 * 2 or 3 commands, maybe some setup gravy around it
>>
>> =A0The rc profile got me close to the second bullet above (C.1 of [1],
>> =A0rest is gravy).
>>
>> =A0The latest release docs are great in terms of their details, I wonder
>> =A0if they appear daunting to new RMs. Perhaps we need a 5-minute releas=
e
>> =A0guide (that says refer to longer version as needed). And no, I don't
>> =A0have a patch but I may look into it :-)
>
> One way to do this might be to have a summary list of the steps
> needed, each of which is linked to the details for that step.
>
> Perhaps the details could be revealed below the step when it is selected?
>
<snip/>

Yeah, potentially one way to skin it. Leave the very meat of each step
in the summary, and link to a detailed setup and troubleshooting kind
of page that can be studied if needed.

-Rahul


>> =A0-Rahul
>>
>> =A0[1] http://wiki.apache.org/commons/CreatingReleases
>>
>>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@commons.apache.org
For additional commands, e-mail: dev-help@commons.apache.org