ASF Release Guidelines

There is a newer version of this page. You can find it here.

A lot of this is automated in scripts/asf-release.sh

Guidelines

DOs

  • Include full name (with version) in name of top level folder in release zip
  • Include [VOTE] and [DISCUSS] tags in thread subject, and cleanly separate the two
  • Ensure only one [VOTE] and one [DISCUSS] thread
  • Use the template below for the [VOTE] thread email
  • When voting on dev@allura, include details of what was tested. E.g.:
    • Sums and sigs OK (log below).
    • Build from source tarball succeeds and passes tests on [list platforms].
    • Extended tests pass on [list platforms].
    • RAT build target passes.
    • Expanded tarball matches version control tag exactly (diff log below).
    • LICENSE and NOTICE assembled according to http://www.apache.org/dev/licensing-howto.html per discussion at [link].
    • LICENSE and NOTICE up-to-date, as no dependencies have been added since initial assembly.
    • All copyleft dependencies purged as documented at [issue].
    • Copyright date in NOTICE is current.
    • CHANGES entry is current.
    • Issue tracker clean (no open issues for this release).
  • After successful vote

DON'Ts

[VOTE] Thread Template

Hello,

This is a call for a vote on Apache Allura {{VERSION}}.

Source tarball and signature are available at:
  https://dist.apache.org/repos/dist/dev/allura/allura-{{VERSION}}.tar.gz
  https://dist.apache.org/repos/dist/dev/allura/allura-{{VERSION}}.tar.gz.asc

Checksums:
  MD5:    {{MD5_CHECKSUM}}  allura-{{VERSION}}.tar.gz
  SHA1:   {{SHA1_CHECKSUM}}  allura-{{VERSION}}.tar.gz
  SHA512: {{SHA512_CHECKSUM}}  allura-{{VERSION}}.tar.gz

The KEYS file can be found at:
  http://www.apache.org/dist/allura/KEYS

The release has been signed with keys (9BB3CE70 and 449C78B1):
  http://pgp.mit.edu:11371/pks/lookup?op=vindex&search=0x56F0526F9BB3CE70
  http://pgp.mit.edu:11371/pks/lookup?op=vindex&search=0xDB6E071B449C78B1

Source corresponding to this release can be found at:
  Commit: {{COMMIT_SHA}}
  Tag:    asf_release_{{VERSION}}
  Browse: https://git-wip-us.apache.org/repos/asf?p=allura.git;a=shortlog;h=refs/tags/asf_release_{{VERSION}}

The RAT report is available at:
  {{RAT_BUILD_LOG_PASTEBIN}}

Vote will be open for at least 72 hours ({{CLOSE_DATE}} 12PM IST).

[ ] +1 approve
[ ] +0 no opinion
[ ] -1 disapprove (and reason why)

Thanks & Regards