Update the release process instructions.

The release process document didn't really mention semver.org or the
rubrics we use to pick version numbers at release.  This patch adds some
hints about picking a version number and looking for API breaking
changes to the code.
This commit is contained in:
Jeff McCune 2011-11-08 14:20:20 -08:00
parent 97d1c692f1
commit 198a52af24

View file

@ -1,13 +1,23 @@
# Releasing this module #
# Contributing to this module #
* Work in a topic branch
* Submit a github pull request
* Address any comments / feeback
* Merge into master using --no-ff
# Releasing this module #
* This module adheres to http://semver.org/
* Look for API breaking changes using git diff vX.Y.Z..master
* If no API breaking changes, the minor version may be bumped.
* If there are API breaking changes, the major version must be bumped.
* If there are only small minor changes, the patch version may be bumped.
* Update the CHANGELOG
* Update the Modulefile
* Commit these changes with a message along the lines of "Update CHANGELOG and Modulefile for release"
* Create an annotated tag with git tag -a X.Y.Z -m 'version X.Y.Z'
* Push the tag with git push origin --tags
* Build a new package with puppet-module
* Build a new package with puppet-module or the rake build task if it exists
* Publish the new package to the forge
* Bonus points for an announcement to puppet-users.