Add release notes for 0.12.0

docs/guide/sources.rst

@@ -48,6 +48,8 @@ We can get data from a given source by using :func:`from_source`:
       - retrieve data from the `Copernicus Atmosphere Data Store <https://ads.atmosphere.copernicus.eu/>`_ (ADS)
     * - :ref:`data-sources-cds`
       - retrieve data from the `Copernicus Climate Data Store <https://cds.climate.copernicus.eu/>`_ (CDS)
+    * - :ref:`data-sources-ecfs`
+      - retrieve data from the ECMWF `ECFS File Storage system <https://confluence.ecmwf.int/display/UDOC/ECFS+user+documentation>`_
     * - :ref:`data-sources-eod`
       - retrieve `ECMWF open data <https://www.ecmwf.int/en/forecasts/datasets/open-data>`_
     * - :ref:`data-sources-fdb`
@@ -670,6 +672,19 @@ cds
       - :ref:`/examples/cds.ipynb`
 
 
+.. _data-sources-ecfs:
+
+ecfs
+-------------------
+
+.. py:function:: from_source("ecfs", path)
+  :noindex:
+
+  The ``ecfs`` source provides access to `ECMWF's File Storage system <https://confluence.ecmwf.int/display/UDOC/ECFS+user+documentation>`_. This service is only available at ECMWF.
+
+  The ``path`` has to start with ``ec:`` followed by the path to the file to retrieve.
+
+
 .. _data-sources-eod:
 
 ecmwf-open-data

docs/install.rst

@@ -45,7 +45,7 @@ Alternatively, you can install the following components:
     - fdb: provides access to the :ref:`data-sources-fdb` source
     - polytope: provides access to the :ref:`data-sources-polytope` source
     - odb: provides full support for the :ref:`odb` data type
-    - geo: enables to use Field.points_unrotated()
+    - geo: enables to use the :py:meth:`Field.points_unrotated()` method
     - geopandas: adds GeoJSON/GeoPandas support
     - projection: adds projection support
     - covjsonkit: provides access to CoverageJSON data served by the :ref:`data-sources-polytope` source

docs/release_notes/index.rst

@@ -4,6 +4,7 @@ Release notes
 .. toctree::
     :maxdepth: 1
 
+    version_0.12_updates
     version_0.11_updates
     version_0.10_updates
     version_0.9_updates

docs/release_notes/version_0.12_updates.rst

@@ -0,0 +1,27 @@
+Version 0.12 Updates
+/////////////////////////
+
+
+Version 0.12.0
+===============
+
+Changes
+++++++++
+
+- Enabled using environment variables to control the :ref:`settings <settings>` (:pr:`565`). See the notebook example:
+
+  - :ref:`/examples/settings_env_vars.ipynb`
+
+- Re-enabled ``headers_only_clone=True`` when calling :meth:`GribMetadata.override() <data.readers.grib.metadata.GribMetadata.override>` (:pr:`567`)
+
+- Added the :ref:`data-sources-ecfs` source to retrieve data from ECMWF's File Storage system (only available at ECMWF) (:pr:`568`)
+- Made ``earthkit-geo`` an optional dependency (:pr:`569`) . See :ref:`install`.
+- Enabled specifying the path to the standalone :ref:`MARS <data-sources-mars>`  client command via the ``MARS_CLIENT_EXECUTABLE`` environment variable (:pr:`566`)
+- Add JAX array backend (:pr:`533`)
+- Allow encoding of PL array for GribCoder (:pr:`546`)
+
+Fixes
++++++
+
+- Fixed issue when ``sel()`` failed on Xarray generated with the earthkit engine from a single GRIB field (:pr:`564`)
+- Fixed issue when could not correctly update the :ref:`settings <settings>` config file from concurrent processes (:pr:`559`)