How to release

Preparation

• Start a reminder issue a few days before the release and label various issues to the release. Leave this issue open until the release is done and close it with a comment to inform the other developers.
• Test the examples and start in issue for non working examples.
• Use empty virtual environment e.g. virtualenv etrago_env --clear -p python3.5 and install new version
• Start documentation of release in doc/whatsnew/ v[X]_[Y].rst
• ...

Day of release

• check setup.py and add new version no.
• ...

Readthedocs

• In case of mayor changes of the files and folder structure create or update the doc/api files for ReadtheDocs by using sphinx-apidoc -o api/ ../etrago/
• check import of packages and add in case if not 'READTHEDOCS' in os.environ: import ...
• include new release massage /news file doc/whatsnew/v[X]_[Y].rst into /doc/whatsnew.rst by adding .. include:: whatsnew/v[X]_[Y].rst
• add new version no. of release in doc/conf.py
• ...

Links:

Based on: How to release (oemof)