commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Rahul Akolkar <rahul.akol...@gmail.com>
Subject Re: [all] Release preparation documentation
Date Wed, 07 Apr 2010 15:01:13 GMT
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:
>>  <snip/>
>>
>> >
>>  > I've been deleting desirable goals from the docs :)
>>  >
>>  > I think it's more desirable that they be short, sweet and focused;
>>  > than that they cover all possibilities.
>>  >
>>
>> <snap/>
>>
>>  Ideally:
>>   * half a screen-full's worth recipe on one webpage, no scrolling
>>   * 2 or 3 commands, maybe some setup gravy around it
>>
>>  The rc profile got me close to the second bullet above (C.1 of [1],
>>  rest is gravy).
>>
>>  The latest release docs are great in terms of their details, I wonder
>>  if they appear daunting to new RMs. Perhaps we need a 5-minute release
>>  guide (that says refer to longer version as needed). And no, I don't
>>  have 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


>>  -Rahul
>>
>>  [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


Mime
View raw message