Hi Julian, As a little disclaimer. I have never successfully done an Apache release, but I spend some time on this topic recently because I'm the release manager of the first Apache release of Flink. So the list of things below just points out what I would do differently.
- No checksum files (md5, sha) - DISCLAIMER file missing (I saw the notice in the README.md and README). It seems that incubator wants an explicit file for that. - "mvn clean verify" is working (so license headers are okay as well) (It was only working after passing -U for the 18.0-rc1 guava artifact) (maybe you should fix the guava version, because a release candidate is usually not what you want. I think if you just set 11.0.2, this means 11.0.2 or higher [1]) - The filename of the zip is prefixed with "apache-", the directory inside the archive is just "optiq". We had a discussion on this on our mailing list. The majority of apache projects does not have the "apache-" prefix for their releases. I personally prefer an "apache-" prefix. - The url in the pom is "http://incubator.apache.org/optiq";, I think incubating projects have "optiq.incubator.apache.org" as their address (similar to the mailing lists) - I could not find the public key (2AD3FAE3) on a public keyserver, the keys are also not available here: http://people.apache.org/keys/ (Once you have the key on a public server and the key fingerprint at id.apache.org), it will be published for Optiq and your name. I found the key inside the archive. $ gpg --recv-keys 2AD3FAE3 gpg: requesting key 2AD3FAE3 from hkp server keys.gnupg.net gpgkeys: key 2AD3FAE3 not found on keyserver gpg: no valid OpenPGP data found. gpg: Total number processed: 0 For my release candidates, I upload a version without the "-SNAPSHOT" suffix into the staging area of nexus. Once the staging is closed, there is a URL that contains the artifacts. The other devs can then test these from the staging repository. Once the vote has passed, I just press "Release" in Nexus and they are going to central. Some feedback on my impressions: There are a lot of small text files in the root directory of the archive. In particular, I would remove the ".travis.yml" file. There are two readme files. I would suggest to merge them. I think you can put the contents of "DEPENDENCIES" into the NOTICE file? And maybe it would make sense to create a docs/ directory with the HOWTO, REFERENCE, PROPOSAL, MODEL and even the HISTORY. Robert [1] http://maven.apache.org/enforcer/enforcer-rules/versionRanges.html On Fri, Aug 15, 2014 at 9:21 PM, Julian Hyde <[email protected]> wrote: > I have prepared a release candidate for apache-optiq-0.9.0-incubating [1]. > This would be our first release under the Apache process. > > This will be a source-only release. (Adding a binary release would > complicate the process, but under Apache source releases are more > important, because they are about the code. Since Optiq is a library, most > people will be happy with the pre-built artifacts that will be available in > Nexus [2].) > > I would like several people to validate this release. Validate it against > the formal check-list [3] and also against the informal criteria “what > would be my impression if I just downloaded this heap of bytes?” > > Please post to this list if you are willing to help. > > If you find problems, or what you suspect to be a problem, please log JIRA > cases. When you have completed the process, please mail this list. > > If I don’t hear objections, I will put this to a release vote shortly. The > process [4] is for the project to first pass a vote for a release, then for > a vote in the Incubator PMC. Once this second vote succeeds, the staged > release is published. If either of the votes fails, we fix issues and make > another release candidate. > > Julian > > [1] http://people.apache.org/~jhyde/apache-optiq-0.9.0-incubating-rc1/ > [2] > https://repository.apache.org/content/repositories/snapshots/org/apache/optiq/ > [3] http://wiki.apache.org/incubator/ReleaseChecklist > [4] > http://incubator.apache.org/guides/releasemanagement.html#best-practice-incubator-release-vote
