On Wed, Apr 7, 2010 at 11:52 AM, sebb <seb...@gmail.com> wrote: > On 07/04/2010, Rahul Akolkar <rahul.akol...@gmail.com> wrote: >> On Tue, Apr 6, 2010 at 1:37 AM, Henri Yandell <flame...@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-unsubscr...@commons.apache.org For additional commands, e-mail: dev-h...@commons.apache.org
