On Sun, Mar 18, 2012 at 09:36:30PM +0100, Christian Grobmeier wrote:
> On Sun, Mar 18, 2012 at 8:42 PM, Gary Gregory <garydgreg...@gmail.com> wrote:
> > That's what the wiki is for no?
> >
> > You could make a page for [math] like
> > http://wiki.apache.org/commons/UsingNexus

I've tried to use that one, and if you followed the exchanges on this list
about it, you certainly noticed that it was not fun.

> 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...

Is it maintained and up-to-date?

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.
[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...]
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

Reply via email to