Whats new updates for v3.8.0rc0 . (#5765)

docs/src/whatsnew/latest.rst → docs/src/whatsnew/3.8.rst

@@ -1,21 +1,42 @@
 .. include:: ../common_links.inc
 
-|iris_version| |build_date| [unreleased]
-****************************************
+v3.8 (21 Feb 2024) [release candidate]
+**************************************
 
 This document explains the changes made to Iris for this release
 (:doc:`View all changes <index>`.)
 
 
-.. dropdown:: |iris_version| Release Highlights
+.. dropdown:: v3.8 Release Highlights
  :color: primary
  :icon: info
  :animate: fade-in
  :open:
 
  The highlights for this major/minor release of Iris include:
 
- * N/A
+ * We have significantly improved :class:`~iris.analysis.AreaWeighted`
+ regridding performance, and added improved regridding documentation (see
+ :ref:`which_regridder_to_use`).
+
+ * We have improved :class:`~iris.cube.Cube`
+ :attr:`~iris.cube.Cube.attributes` handling to better preserve local and
+ global attribute metadata.
+
+ * We have implemented the
+ :data:`iris.fileformats.netcdf.loader.CHUNK_CONTROL` context manager to
+ offer greater control to NetCDF chunking (see :ref:`netcdf_io`).
+
+ * We have added functionality to mask cubes using shapefiles via
+ :func:`iris.util.mask_cube_from_shapefile` (see
+ :ref:`masking-from-shapefile`).
+
+ * We have added :attr:`~iris.coords.Coord.ignore_axis` to allow for
+ preventing :func:`~iris.util.guess_coord_axis` acting on desired
+ coordinates.
+
+ * We have begun adding improvements to Iris' warnings, to prevent warning
+ duplication.
 
  And finally, get in touch with us on :issue:`GitHub<new/choose>` if you have
  any issues or feature requests for improving Iris. Enjoy!

docs/src/whatsnew/index.rst

@@ -5,13 +5,13 @@
 What's New in Iris
 ------------------
 
-.. include:: latest.rst
+.. include:: 3.8.rst
 
 .. toctree::
  :maxdepth: 1
  :hidden:
 
- latest.rst
+ 3.8.rst
  3.7.rst
  3.6.rst
  3.5.rst