Release how-to
==============

Here are the step by step instructions to release a new version of xESMF.

#. Make sure :file:`CHANGES.rst` is up to date and includes a section on the version to be released, usually this is done through a pull request.
#. On GitHub, go the Releases_ page and click on :guilabel:`Draft a new release`;
#. Enter new version in :guilabel:`Tag version` (e.g. v<major>.<minor>.<patch>);
#. Enter the :guilabel:`Release title` (e.g. the same tag);
#. Copy the relevant section of :file:`CHANGES.rst` in the description;
#. Click :guilabel:`Publish release`;

.. _Releases: https://github.com/pangeo-data/xESMF/releases
.. _Actions: https://github.com/pangeo-data/xESMF/actions