commons-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Luc Maisonobe <>
Subject Re: [Math] Release mini-howto
Date Mon, 19 Mar 2012 07:15:53 GMT
Hi Christian,

Le 19/03/2012 01:01, Christian Grobmeier a écrit :
> On Mon, Mar 19, 2012 at 12:25 AM, Gilles Sadowski
> <> wrote:
>>> Not to forget the grandfather of release guides:
>> 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. :-)

So perhaps rather than creating a third document, these recent notes
should replace the existing pages and get linked to everything else.
Otherwise we would end up with 3 documents and another release manager
candidate would stumble upon an old one, then create a fourth document,
then be pointed to this one and say he didn't know it existed, then put
this fourth document on-line, then ...


>> 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:
>> For additional commands, e-mail:

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message