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