Release instructions

1. Set the release date in NEWS.
2. Merge the pull request for the new release.
3. Build the manual locally and glance over the result.
4. Build and test the PyPI package on your local machine (see https://packaging.python.org/distributing/ for complete instructions).
   • git clean -dfx
   • git tag x.y.z -m 'Version x.y.z'
   • Make sure that version.py is up to date (run python3 get_version.py) before making the final distribution package.
   • 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
5. Publish the release on GitHub.
   • git push --tags origin
   • Add an item to https://github.com/hylang/hy/releases .
6. Fast-forward the stable branch on GitHub.
7. Upload the new manual to Hylang.org.
   • Update HY-LATEST-DOCS-VERSION on the server.
8. Update the redirects http://hylang.org/hy/doc and http://hylang.org/hyrule/doc .
9. Let @paultag and @Kodiologist know that things are ready. Either of them can upload the package into PyPI.
   • twine upload dist/*
10. Similarly, publish the corresponding new release of Hyrule.

• Update hy_version in Hyrule's docs/conf.py.
• Add a commit (only for the new version tag, not master) that sets Hyrule's version number and declares a dependency on the Hy release in setup.py.

11. Use the new releases of Hy and Hyrule for Try Hy.