release v0.12.0 (#514)

CHANGELOG.rst

@@ -10,9 +10,13 @@ Changelog
 
 .. _changelog.0.12.0:
 
-v0.12.0 (unreleased)
+v0.12.0 (21.03.2024)
 --------------------
 
+regionmask v0.12.0 adds a new approximate fractional overlap mask, fixes a number of issues
+with certain natural earth regions and restores compatibility with the upcoming xarray
+release.
+
 Breaking Changes
 ~~~~~~~~~~~~~~~~
 
@@ -66,6 +70,7 @@ Internal Changes
 - Restore compatibility with upcoming xarray release (probably v2023.04 or v2024.04, :pull:`#512`).
 - Small optimizations for :py:class:`Regions` (:pull:`#478`).
 
+.. _changelog.0.11.0:
 
 v0.11.0 (22.09.2023)
 --------------------
@@ -133,6 +138,7 @@ Internal Changes
 - Add upstream-dev CI check to ensure regionmask works with the developmen version of
   its dependencies (:pull:`444`).
 
+.. _changelog.0.10.0:
 
 v0.10.0 (31.05.2023)
 --------------------
@@ -323,6 +329,8 @@ Internal Changes
 - Add `packaging` as a dependency (:issue:`324`, :pull:`328`).
 - Add python 3.10 to list of supported versions (:pull:`330`).
 
+.. _whats-new.0.8.0:
+
 v0.8.0 (08.09.2021)
 -------------------
 
@@ -412,6 +420,8 @@ Internal Changes
   not happen and turn the timeout Error into a warning (:pull:`261`).
 - Set ``regex=True`` in ``pd.Series.str.replace`` due to an upcoming change in pandas (:pull:`262`).
 
+.. _whats-new.0.7.0:
+
 v0.7.0 (28.07.2021)
 -------------------
 
@@ -498,6 +508,8 @@ Internal Changes
 - Enforce minimum versions in `requirements.txt` and clean up required dependencies
   (:issue:`199` and :pull:`219`).
 
+.. _whats-new.0.6.2:
+
 v0.6.2 (19.01.2021)
 -------------------
 
@@ -515,12 +527,16 @@ Bug Fixes
   the regions as 32, 30, 31). This can lead to problems for :py:meth:`Regions.mask_3D` and
   :py:func:`mask_3D_geopandas` (:issue:`200`).
 
+.. _whats-new.0.6.1:
+
 v0.6.1 (19.08.2020)
 -------------------
 
 There were some last updates to the AR6 regions (``regionmask.defined_regions.ar6``).
 If you use the AR6 regions please update the package. There were no functional changes.
 
+.. _whats-new.0.6.0:
+
 v0.6.0 (30.07.2020)
 -------------------
 
@@ -609,6 +625,8 @@ Docs
 - Set ``mpl.rcParams["savefig.bbox"] = "tight"`` in ``docs/defined_*.rst`` to avoid
   spurious borders in the map plots (:issue:`112`).
 
+.. _whats-new.0.5.0:
+
 v0.5.0 (19.12.2019)
 -------------------
 
@@ -699,6 +717,8 @@ Bug Fixes
    figures).
  - Fix wrong figure in docs: countries showed landmask (:issue:`39`).
 
+.. _whats-new.0.4.0:
+
 v0.4.0 (02.03.2018)
 -------------------
 
@@ -716,6 +736,8 @@ Bug Fixes
 - Links to github issues not working, due to missing sphinx.ext.extlinks (:issue:`26`).
 - Docs: mask_xarray.ipynb: mask no longer needs a name (as of :pull:`5`).
 
+.. _whats-new.0.3.1:
+
 v0.3.1 (4 October 2016)
 -----------------------
 
@@ -734,12 +756,14 @@ Bug Fixes
 - Removed unnecessary files (ne_downloader.py and naturalearth.py).
 - Resolved conflicting region outlines in the Giorgi regions (:issue:`17`).
 
+.. _whats-new.0.3.0:
 
 v0.3.0 (20 September 2016)
 --------------------------
 
 - Allow passing 2 dimensional latitude and longitude grids (:issue:`8`).
 
+.. _whats-new.0.2.0:
 
 v0.2.0 (5 September 2016)
 -------------------------
@@ -748,6 +772,8 @@ v0.2.0 (5 September 2016)
 - overhaul of the documentation
 - move rtd / matplotlib handling to background
 
+.. _whats-new.0.1.0:
+
 v0.1.0 (15 August 2016)
 -----------------------