Maintainer / core-developer information

For more information see https://github.com/scikit-learn/scikit-learn/wiki/How-to-make-a-release

Making a release

1. Update docs:

   • edit the doc/whats_new.rst file to add release title and commit statistics. You can retrieve commit statistics with:

     $ git shortlog -ns 0.998..
     

   • edit the doc/index.rst to change the ‘News’ entry of the front page.

2. Update the version number in sklearn/__init__.py, the __version__ variable

3. Create the tag and push it:

   $ git tag 0.999
   
   $ git push origin --tags
   

4. create tarballs:

   • Wipe clean your repo:

     $ git clean -xfd
     

   • Register and upload on PyPI:

     $ python setup.py sdist register upload
     

5. Push the documentation to the website. Circle CI should do this automatically for master and <N>.<N>.X branches.

6. Build binaries using dedicated CI servers by updating the git submodule reference to the new scikit-learn tag of the release at:

   https://github.com/MacPython/scikit-learn-wheels

   Once the CI has completed successfully, collect the generated binary wheel packages and upload them to PyPI by running the following commands in the scikit-learn source folder (checked out at the release tag):

   $ pip install -U wheelhouse_uploader
   $ python setup.py sdist fetch_artifacts upload_all
   

7. FOR FINAL RELEASE: Update the release date in What’s New