Release Packaging

The following are step by step instructions on how to package a release.

Building the Release Packages

Source Code

Step 1

Make sure the code builds on Travis http://travis-ci.org/geopython/MetaSearch

Step 2

TODO: more steps / tests needed

Step 3

Create a release tag against master:

* update desired branch with `x.y.z` in the following files:
 * `VERSION.txt`
 * `plugin/MetaSearch/metadata.txt` (update the version value)
* add major items in new line in `plugin/MetaSearch/metadata.txt`, changelog value

• commit the above updates:

```
# in branch master
$ git commit -am 'update release version'
$ git push origin master
```

Tag Release
Release tags are in the format `x.y.z`

If releasing from master:

```
$ git tag -a x.y.z -m 'tagging x.y.z'
$ git push --tags
```

If releasing from a branch:

```
$ git checkout x.y
$ git tag -a x.y.z -m 'tagging x.y.z'
$ git push --tags
```

Step 4

Upload package to plugins.qgis.org:

```
$ paver upload -u $OSGEO_USERID  # you will be prompted for your password
```

Step 5

Publish documentation:

$ paver publish_docs

Step 10

Update master with the development version to x.y-dev in the following files:

• VERSION.txt
• plugin/MetaSearch/metadata.txt

git commit -am 'update development version'

...and then git push origin master

Step 11

Email announcement to:

• qgis-developer
• Twitter
• Google+

Message Template

Subject: MetaSearch x.y.z released

The MetaSearch team announces the release of MetaSearch x.y.z. 

[High level overview of release]

MetaSearch is a core QGIS plugin.  x.y.z will be part of the upcoming QGIS x.y release.

The plugin can also be found on the QGIS Plugins Repository at http://plugins.qgis.org/plugins/MetaSearch

MetaSearch is a QGIS plugin to interact with metadata catalogue services (CSW).

Version x.y.z (YYYY-MM-DD):
---------------------------

[Bulleted list of enhancements / bug fixes]

Testers and developers are welcome.

The MetaSearch team.

http://geopython.github.io/MetaSearch

Step 12

Update OSGeo-Live (for final releases only, not beta or rc releases):

TODO: @kalxas to add steps