HowToRelease

Some developer notes on how to do the release (magic numbers are for version 1.1):

1. Create a Release Notes page on the wiki (with some sensible content in it!) and modify History to link it.

2. Commit new version number (one change in setup.py, one in docs/conf.py):

   git commit -a
   

   with commit message like:

   Version 1.1.0
   
   https://github.com/cms-dev/cms/wiki/CMS-1.1.0-RELEASE-NOTES
   

3. Tag the commit:

   git tag v1.1.0
   

4. Create a branch for the version number:

   git checkout -b v1.1
   

5. Push branch and tag to the repository. Push also changes to the wiki.

6. Check that relevant automatic links have been created by GitHub, so that there are no 404 errors around (in wiki and in docs).

7. Send Release Notes to the mailing list (for reference: http://www.freelists.org/post/contestms/CMS-100-RELEASE-NOTES).

8. Go back to master and commit new version numbers (one change in setup.py, two changes in docs/conf.py).