whatsnew - links and versions (#3853)

* whatsnew - links and versions

* review actions

Author: bjlittle

docs/iris/src/whatsnew/latest.rst

@@ -74,15 +74,12 @@ This document explains the changes made to Iris for this release
   ``volume`` are the only accepted values. (:pull:`3533`)
 
 * `@trexfeathers`_ set **all** plot types in `iris.plot` to now use
-  `matplotlib.dates.date2num
-  <https://matplotlib.org/api/dates_api.html#matplotlib.dates.date2num>`_
-  to format date/time coordinates for use on a plot axis (previously
-  :meth:`~iris.plot.pcolor` and :meth:`~iris.plot.pcolormesh` did not include
-  this behaviour). (:pull:`3762`)
+  `matplotlib.dates.date2num`_ to format date/time coordinates for use on a plot
+  axis (previously :meth:`~iris.plot.pcolor` and :meth:`~iris.plot.pcolormesh`
+  did not include this behaviour). (:pull:`3762`)
 
 * `@trexfeathers`_ changed date/time axis labels in `iris.quickplot` to now
-  **always** be based on the ``epoch`` used in `matplotlib.dates.date2num
-  <https://matplotlib.org/api/dates_api.html#matplotlib.dates.date2num>`_
+  **always** be based on the ``epoch`` used in `matplotlib.dates.date2num`_
   (previously would take the unit from a time coordinate, if present, even
   though the coordinate's value had been changed via ``date2num``).
   (:pull:`3762`)
@@ -159,7 +156,6 @@ This document explains the changes made to Iris for this release
 🔗 Dependencies
 ===============
 
-
 * `@stephenworsley`_, `@trexfeathers`_ and `@bjlittle`_ removed ``Python2``
   support, modernising the codebase by switching to exclusive ``Python3``
   support. (:pull:`3513`)
@@ -169,20 +165,19 @@ This document explains the changes made to Iris for this release
   dependencies is now easier with our curated conda environment YAML files.
   (:pull:`3812`)
 
-* `@stephenworsley`_ pinned Iris to require Dask >= 2.0. (:pull:`3460`)
+* `@stephenworsley`_ pinned Iris to require `Dask`_ ``>=2.0``. (:pull:`3460`)
 
 * `@stephenworsley`_ and `@trexfeathers`_ pinned Iris to require
-  `Cartopy <https://github.com/SciTools/cartopy>`_ >= 0.18, in
-  order to remain compatible with the latest version of `Matplotlib`_.
-  (:pull:`3762`)
+  `Cartopy`_ ``>=0.18``, in order to remain compatible with the latest version
+  of `Matplotlib`_. (:pull:`3762`)
 
 * `@bjlittle`_ unpinned Iris to use the latest version of `Matplotlib`_.
   Supporting ``Iris`` for both ``Python2`` and ``Python3`` had resulted in
   pinning our dependency on `Matplotlib`_ at ``v2.x``.  But this is no longer
   necessary now that ``Python2`` support has been dropped. (:pull:`3468`)
 
 * `@stephenworsley`_ and `@trexfeathers`_ unpinned Iris to use the latest version
-  of `Proj <https://github.com/OSGeo/PROJ>`_. (:pull:`3762`)
+  of `Proj`_. (:pull:`3762`)
 
 * `@stephenworsley`_ and `@trexfeathers`_ removed GDAL from the extensions
   dependency group. We no longer consider it to be an extension. (:pull:`3762`)
@@ -198,10 +193,9 @@ This document explains the changes made to Iris for this release
 * `@tkknight`_ updated documentation to use a modern sphinx theme and be
   served from https://scitools-iris.readthedocs.io/en/latest/. (:pull:`3752`)
 
-* `@bjlittle`_ added support for the
-  `black <https://black.readthedocs.io/en/stable/>`_ code formatter. This is
+* `@bjlittle`_ added support for the `black`_ code formatter. This is
   now automatically checked on GitHub PRs, replacing the older, unittest-based
-  "iris.tests.test_coding_standards.TestCodeFormat". Black provides automatic
+  ``iris.tests.test_coding_standards.TestCodeFormat``. Black provides automatic
   code format correction for most IDEs.  See the new developer guide section on
   :ref:`iris_code_format`. (:pull:`3518`)
 
@@ -233,9 +227,8 @@ This document explains the changes made to Iris for this release
 💼 Internal
 ===========
 
-* `@pp-mo`_ and `@lbdreyer`_ removed all test dependencies on
-  `SciTools/iris-grib <https://github.com/SciTools/iris-grib>`_ by transferring
-  all relevant content to the iris-grib repository. (:pull:`3662`,
+* `@pp-mo`_ and `@lbdreyer`_ removed all Iris test dependencies on `iris-grib`_
+  by transferring all relevant content to the `iris-grib`_ repository. (:pull:`3662`,
   :pull:`3663`, :pull:`3664`, :pull:`3665`, :pull:`3666`, :pull:`3669`,
   :pull:`3670`, :pull:`3671`, :pull:`3672`, :pull:`3742`, :pull:`3746`)
 
@@ -248,31 +241,23 @@ This document explains the changes made to Iris for this release
 
 * `@stephenworsley`_ changed the numerical values in tests involving the
   Robinson projection due to improvements made in
-  `Proj <https://github.com/OSGeo/PROJ>`_. (:pull:`3762`) (see also
-  `proj#1292 <https://github.com/OSGeo/PROJ/pull/1292>`_ and
-  `proj#2151 <https://github.com/OSGeo/PROJ/pull/2151>`_)
+  `Proj`_. (:pull:`3762`) (see also `Proj#1292`_ and `Proj#2151`_)
 
 * `@stephenworsley`_ changed tests to account for more detailed descriptions of
-  projections in `GDAL <https://github.com/OSGeo/gdal>`_. (:pull:`3762`)
-  (`see also GDAL#1185 <https://github.com/OSGeo/gdal/pull/1185>`_)
+  projections in `GDAL`_. (:pull:`3762`) (see also `GDAL#1185`_)
 
-* `@stephenworsley`_ changed tests to account for
-  `GDAL <https://github.com/OSGeo/gdal>`_ now saving fill values for data
-  without masked points. (:pull:`3762`)
+* `@stephenworsley`_ changed tests to account for `GDAL`_ now saving fill values
+  for data without masked points. (:pull:`3762`)
 
-* `@trexfeathers`_ changed every graphics test that includes `Cartopy's coastlines
-  <https://scitools.org.uk/cartopy/docs/latest/matplotlib/
-  geoaxes.html?highlight=coastlines#cartopy.mpl.geoaxes.GeoAxes.coastlines>`_
-  to account for new adaptive coastline scaling. (:pull:`3762`) (`see also
-  cartopy#1105 <https://github.com/SciTools/cartopy/pull/1105>`_)
+* `@trexfeathers`_ changed every graphics test that includes `Cartopy's coastlines`_
+  to account for new adaptive coastline scaling. (:pull:`3762`)
+  (see also `Cartopy#1105`_)
 
 * `@trexfeathers`_ changed graphics tests to account for some new default
-  grid-line spacing in `Cartopy <https://github.com/SciTools/cartopy>`_.
-  (:pull:`3762`)
-  (`see also cartopy#1117 <https://github.com/SciTools/cartopy/pull/1117>`_)
+  grid-line spacing in `Cartopy`_. (:pull:`3762`) (see also `Cartopy#1117`_)
 
 * `@trexfeathers`_ added additional acceptable graphics test targets to account
-  for very minor changes in `Matplotlib`_ version 3.3 (colormaps, fonts and
+  for very minor changes in `Matplotlib`_ version ``3.3`` (colormaps, fonts and
   axes borders). (:pull:`3762`)
 
 * `@rcomer`_ corrected the Matplotlib backend in Iris tests to ignore
@@ -284,6 +269,19 @@ This document explains the changes made to Iris for this release
 .. _Matplotlib: https://matplotlib.org/
 .. _CF Ancillary Data: https://cfconventions.org/Data/cf-conventions/cf-conventions-1.8/cf-conventions.html#ancillary-data
 .. _Quality Flags: https://cfconventions.org/Data/cf-conventions/cf-conventions-1.8/cf-conventions.html#flags
+.. _iris-grib: https://github.com/SciTools/iris-grib
+.. _Cartopy: https://github.com/SciTools/cartopy
+.. _Cartopy's coastlines: https://scitools.org.uk/cartopy/docs/latest/matplotlib/geoaxes.html?highlight=coastlines#cartopy.mpl.geoaxes.GeoAxes.coastlines
+.. _Cartopy#1105: https://github.com/SciTools/cartopy/pull/1105
+.. _Cartopy#1117: https://github.com/SciTools/cartopy/pull/1117
+.. _Dask: https://github.com/dask/dask
+.. _matplotlib.dates.date2num: https://matplotlib.org/api/dates_api.html#matplotlib.dates.date2num
+.. _Proj: https://github.com/OSGeo/PROJ
+.. _black: https://black.readthedocs.io/en/stable/
+.. _Proj#1292: https://github.com/OSGeo/PROJ/pull/1292
+.. _Proj#2151: https://github.com/OSGeo/PROJ/pull/2151
+.. _GDAL: https://github.com/OSGeo/gdal
+.. _GDAL#1185: https://github.com/OSGeo/gdal/pull/1185
 .. _@MoseleyS: https://github.com/MoseleyS
 .. _@stephenworsley: https://github.com/stephenworsley
 .. _@pp-mo: https://github.com/pp-mo