Releasing Grok

Steps to take to make a new release of Grok.

This how-to is an addendum to the more general "Releasing Software" document. When releasing Grok, the following steps should be taken:

First and foremost follow the exact procedure described in the "Releasing Software" document.
After having tagged and released Grok, the versions.cfg for this version needs to be uploaded to grok.zope.org/releaseinfo.

Copy versions.cfg to grok-[VERSION].cfg where [VERSION] needs to represent the released version. For example grok-0.13.cfg. Add grok's version to this file:
```
[versions]
grok = 0.13
...
```
Then upload this file:
```
$ scp ./grok-[VERSION].cfg grok.zope.org:/var/www/html/grok/releaseinfo/
```
Grokproject generates a buildout.cfg with an extends directive pointing to the most recent release versions file. It determines the URL to this versions file by reading http://grok.zope.org/releaseinfo/current. This file needs to be updated to point to the uploaded *.cfg file.
Grokproject is able to download and use a tarball containing Grok and all packages Grok depends on. This will speed up the initial buildout run. To create this tarball use the bundlemaker command from the Grok buildout directory:
```
$ ./bin/bundlemaker
```

Then upload the created tarball to grok.zope.org/releaseinfo/:

$ scp ./grok-eggs-0.13.tgz grok.zope.org:/var/www/html/grok/releaseinfo/

Add a document with the release announcement in the releases folder Name it after the release version number. Summarize what is in CHANGES.txt. Make sure you move it to become the first item of the releases folder. You can move it up by using the contents view of the folder. The last column in that table presents a handle by which you can drag up the document in the folder.

Create a news item in the blog folder announcing the news. The text can be based on the release notes written at point 7.

Make both the new release notes, the new news item, as well as the updated upgrade notes public.
Update the sidebar in the site. You can edit it here: http://grok.zope.org/portal_skins/custom/portlet_download/manage_main
Community Documentation: Update the Plone Help Center used for Grok Community Documentation so that the new Version is available. Important: you can select multiple "current" versions for community documentation, any documentation for a release which is not "current" gets a big nasty "outdated" header at the top of it. We only want to do this for documentation which is truly outdated and no longer best practice. Do this here: http://grok.zope.org/documentation/edit
Official Documentation: Create a build of the docs from the tagged release and copy it to the server. Detailed steps are documented in the Updating the Official Grok Docuementation (OGD) page.
Send out an email to at least zope-announce@zope.org as well as grok-dev@zope.org announcing the new release. The text can be based on the release notes written at point 7.
Update the Grok Wikipedia article with the information about the latest release: http://en.wikipedia.org/wiki/Grok_(web_framework)