snip..
There's already lots of doc about doing releases in the ASF - on the ASF main dev pages and within the Incubator site etc.
The problem with there being lots of docs is that there are, ahem, lots of docs. Where is the definitive set of guides that provide the detail required to release Tuscany for someone, like me, who hasn't done it before? Possibly an impossible question to answer as you don't know what I don't know and I don't know what you do know so our view of what is an acceptable level of detail probably differs. Here are the top level guides I found. http://www.apache.org/dev/#rreleases http://incubator.apache.org/guides/releasemanagement.html I can't say whether the above links are satisfactory as I haven't been through the process but I agree that we should propose updates if they are found to be wanting. For example, a discussion of RAT. For consistency I would expect to see all the keystrokes recorded that are required to produce and distribute a release. The fewer the better so, yes, more automation would be good. I expect automation does not completely remove the responsibility to check the release against release criteria, e,g, legal, but gives a good indication of what is required to make the release happen. Again anything we can do to automate these checks is good. I don't expect that release is a process that should involve a lot of imagination on our part other than in providing more automation of the required steps. To put it another way is there anything specific we have to do for Tuscany that would not be included in the general guide? I note that many projects do have release guides. Why is this the case? http://httpd.apache.org/dev/release.html http://cayenne.apache.org/release-guide.html http://incubator.apache.org/servicemix/release-guide.html http://activemq.apache.org/release-guide.html I do note that the Incubator release guide states "Different options or opinions are encouraged.". If options are offered (and I can't say that there are without reading the detail) then we need a place to document which are chosen for Tuscany releases. Simon
