Release procedure

Pre-requisites

Must have push rights to the GitHub repository
Must be a maintainer or owner of the project on PyPI
Must have valid PyPI credentials in ~/.pypirc
Should be a maintainer of the project on ReadTheDocs

Release

Update version number in mosromgr/__init__.py
Update changelog with summary of changes in docs/changelog.rst
Ensure all code changes are reflected in the documentation and that the documentation builds correctly (make doc)
Commit final changes and tag with the version number:
```
git tag -a v0.8.1 -m v0.8.1
```
Push to GitHub, including tags:
```
git push
git push --tags
```
Run make build to create source (.tar.gz) and binary (.whl) distributions in dist/
Run make release to release source and binary distribution files to PyPI
ReadTheDocs should build the new version automatically if the connection to GitHub is active. Verify and login to check status if needed. There should be a new version available, and the stable branch of the docs should now reflect the new release.

Bus factor

GitHub owners:

BBC / News Labs team

PyPI owners:

Ben Nuttall
Rich Wareham

ReadTheDocs owners:

Ben Nuttall
Rich Wareham