-
Notifications
You must be signed in to change notification settings - Fork 690
Publishing a maintenance release
sandal edited this page Sep 28, 2014
·
37 revisions
- Verify that the code in the
stable
branch is what you actually want to release. - Make sure that the VERSION file matches the release you want to make.
- Build the manual and do a quick visual skim of its contents to make sure it's working properly.
- Run the tests on the stable branch. Make sure you can get a passing local build.
- Check the latest Travis CI builds for the stable branch and make sure they match the current latest commit, and are green across all supported Rubies.
- Copy relevant notes from MasterCHANGELOG to CHANGELOG.
- Make sure CHANGELOG is fully up to date. Verify by looking at git history, even if it looks right.
- If any new documentation was added to the manual in this release, upload a new version of the manual to the github pages website. (TODO: explain this in more detail)
- If any new API docs were written, upload a new version to the github pages site. (TODO: explain this in more detail)
- Tag the new release in git
- Build a new gem and upload to rubygems.org
- Try to find someone else to install the gem and run it if possible, or at least do a "hello world" test at the minimum yourself.
- Bump the stable version in lib/prawn/version.rb (for the next release).
- Prepare a blog post for elmcitycraftworks.org (we'll later move these announcements to prawnpdf.org)
- Announce on prawn-ruby mailing list and on Twitter. See previous announcements for examples.
- Update development roadmap with a note about the release.
- If you have the time to do it, now would be a good time to delete any branches that have either been merged or rejected.