Release instructions

1. Update hyrule_version in Hy's docs/conf.py.
   • Make sure that at least http://hylang.org/hyrule/doc/NEW_HYRULE_VERSION/objects.inv is online.
2. Set the release date in NEWS.
3. Merge the pull request for the new release.
4. Set the new version in __init__.py and setup.py.
5. git tag x.y.z -m 'Version x.y.z'
6. Build the manual locally and glance over the result.
7. Build and test the PyPI package on your local machine (see https://packaging.python.org/distributing/ for complete instructions).
   • git clean -dfx
   • python3 setup.py sdist to create the source distribution.
     • We no longer distribute wheels, because this prevents precompiling the Hy code during installation.
   • Create a new virtualenv and install the created package there for testing:
     • virtualenv tenv -p python3 && cd tenv && source ./bin/activate && pip install fastentrypoints && pip install [source distribution file] && deactivate && source ./bin/activate && echo `type hy` && echo '(+ 1 1)' | hy -i
8. Publish the release on GitHub.
   • git push --tags origin
   • Add an item to https://github.com/hylang/hy/releases .
9. Fast-forward the stable branch on GitHub.
10. Upload the new manual to Hylang.org.

• Update HY-LATEST-DOCS-VERSION on the server.

11. Update the redirects http://hylang.org/hy/doc and http://hylang.org/hyrule/doc .
12. Let @paultag and @Kodiologist know that things are ready. Either of them can upload the package into PyPI.

• twine upload dist/*

13. Push a commit to Hy master reverting the addition of the version number.
14. Similarly, publish the corresponding new release of Hyrule.
15. Use the new releases of Hy and Hyrule for Try Hy.