Hi Christian, Le 19/03/2012 01:01, Christian Grobmeier a écrit : > 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. :-)
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 ... Luc > >> 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 >> > > > --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org For additional commands, e-mail: dev-h...@commons.apache.org
