On Mon, Mar 19, 2012 at 12:25 AM, Gilles Sadowski
<gil...@harfang.homelinux.org> wrote:
>> Not to forget the grandfather of release guides:
>> http://commons.apache.org/releases/release.html
>
> I've just had a brief look at that one; I did not know it existed...

not very well linked imho... if it is linked

> Is it maintained and up-to-date?

Same situation like UsingNexus: the guys who use it, should update it.
Sometimes it happens. :-)

> What I noticed with "UsingNexus" is that people who know how to release
> certainly did not follow exactly what was described there; otherwise they
> would have stumbled on the problems which I faced.
>
> That is often the problem with such documents: newbies cannot fill in the
> blanks and experts do not need to read them. Thus they are useless.
>
> My document is a step-by-step recipe; it contains the strict minimum, and
> what needs to be supplied (login, password, GPG key, ssh key, ...) clearly
> stands out.

Hard to judge without looking at it. Anyway good documentation is
always welcome.
it seems you already made the effort... why don't you put it on the
wiki? We can then discuss if we should take yours and pimp it (if
necessary), or improve the other docs with your content.

> [By following it, someone who never prepared a release could do it in a few
> minutes, not the many hours I spent figuring out why maven did not seem to
> behave like the "UsingNexus" document assumed it should...]

Sounds good! Lets review your work

Cheers
Christian

> My document is not a explanation of maven or svn or nexus or ssh or gpg; it
> just enumerates the release steps in the correct order, with the correct
> commands and correct config files samples (as of last week).
>
>
> Regards,
> Gilles
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org
> For additional commands, e-mail: dev-h...@commons.apache.org
>



-- 
http://www.grobmeier.de
https://www.timeandbill.de

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

Reply via email to