diff --git a/doc/api.rst b/doc/api.rst
index 840fa32bf43..f9770090e5e 100644
--- a/doc/api.rst
+++ b/doc/api.rst
@@ -648,11 +648,23 @@ DataArray methods
Coordinates objects
===================
+Dataset
+-------
+
.. autosummary::
:toctree: generated/
- core.coordinates.DataArrayCoordinates
core.coordinates.DatasetCoordinates
+ core.coordinates.DatasetCoordinates.dtypes
+
+DataArray
+---------
+
+.. autosummary::
+ :toctree: generated/
+
+ core.coordinates.DataArrayCoordinates
+ core.coordinates.DataArrayCoordinates.dtypes
Plotting
========
@@ -812,6 +824,7 @@ DataArray
:toctree: generated/
DataArrayRolling
+ DataArrayRolling.__iter__
DataArrayRolling.construct
DataArrayRolling.reduce
DataArrayRolling.argmax
diff --git a/doc/whats-new.rst b/doc/whats-new.rst
index 9e6a4a3ceac..c7a2a50a73f 100644
--- a/doc/whats-new.rst
+++ b/doc/whats-new.rst
@@ -16,33 +16,44 @@ What's New
.. _whats-new.2022.06.0:
-v2022.06.0 (unreleased)
------------------------
+v2022.06.0 (July 21, 2022)
+--------------------------
+
+This release brings a number of bug fixes and improvements, most notably a major internal
+refactor of the indexing functionality, the use of `flox`_ in ``groupby`` operations,
+and experimental support for the new Python `Array API standard `_.
+It also stops testing support for the abandoned PyNIO.
+
+Much effort has been made to preserve backwards compatibility as part of the indexing refactor.
+We are aware of one `unfixed issue `_.
+
+Please also see the `whats-new.2022.06.0rc0`_ for a full list of changes.
+
+Many thanks to our 18 contributors:
+Bane Sullivan, Deepak Cherian, Dimitri Papadopoulos Orfanos, Emma Marshall, Hauke Schulz, Illviljan,
+Julia Signell, Justus Magin, Keewis, Mathias Hauser, Michael Delgado, Mick, Pierre Manchon, Ray Bell,
+Spencer Clark, Stefaan Lippens, Tom White, Travis A. O'Brien,
New Features
~~~~~~~~~~~~
-- Add :py:meth:`Dataset.dtypes`, :py:meth:`DatasetCoordinates.dtypes`,
- :py:meth:`DataArrayCoordinates.dtypes` properties: Mapping from variable names to dtypes.
+- Add :py:attr:`Dataset.dtypes`, :py:attr:`core.coordinates.DatasetCoordinates.dtypes`,
+ :py:attr:`core.coordinates.DataArrayCoordinates.dtypes` properties: Mapping from variable names to dtypes.
(:pull:`6706`)
By `Michael Niklas `_.
- Initial typing support for :py:meth:`groupby`, :py:meth:`rolling`, :py:meth:`rolling_exp`,
:py:meth:`coarsen`, :py:meth:`weighted`, :py:meth:`resample`,
(:pull:`6702`)
By `Michael Niklas `_.
-- Experimental support for wrapping any array type that conforms to the python array api standard.
- (:pull:`6804`)
+- Experimental support for wrapping any array type that conforms to the python
+ `array api standard `_. (:pull:`6804`)
By `Tom White `_.
-Deprecations
-~~~~~~~~~~~~
-
-
Bug fixes
~~~~~~~~~
-- :py:meth:`xarray.save_mfdataset` now passes ``**kwargs`` on to ``to_netcdf``,
- allowing the ``encoding`` and ``unlimited_dims`` options with ``save_mfdataset``.
+- :py:meth:`save_mfdataset` now passes ``**kwargs`` on to :py:meth:`Dataset.to_netcdf`,
+ allowing the ``encoding`` and ``unlimited_dims`` options with :py:meth:`save_mfdataset`.
(:issue:`6684`)
By `Travis A. O'Brien `_.
- Fix backend support of pydap versions <3.3.0 (:issue:`6648`, :pull:`6656`).
@@ -61,16 +72,12 @@ Bug fixes
(:issue:`6739`, :pull:`6744`)
By `Michael Niklas `_.
-Documentation
-~~~~~~~~~~~~~
-
-
Internal Changes
~~~~~~~~~~~~~~~~
-- :py:meth:`xarray.core.groupby`, :py:meth:`xarray.core.rolling`,
- :py:meth:`xarray.core.rolling_exp`, :py:meth:`xarray.core.weighted`
- and :py:meth:`xarray.core.resample` modules are no longer imported by default.
+- ``xarray.core.groupby``, ``xarray.core.rolling``,
+ ``xarray.core.rolling_exp``, ``xarray.core.weighted``
+ and ``xarray.core.resample`` modules are no longer imported by default.
(:pull:`6702`)
.. _whats-new.2022.06.0rc0:
@@ -123,7 +130,7 @@ New Features
elements which trigger summarization rather than full repr in (numpy) array
detailed views of the html repr (:pull:`6400`).
By `Benoît Bovy `_.
-- Allow passing chunks in ``**kwargs`` form to :py:meth:`Dataset.chunk`, :py:meth:`DataArray.chunk`, and
+- Allow passing chunks in ``kwargs`` form to :py:meth:`Dataset.chunk`, :py:meth:`DataArray.chunk`, and
:py:meth:`Variable.chunk`. (:pull:`6471`)
By `Tom Nicholas `_.
- Add :py:meth:`core.groupby.DatasetGroupBy.cumsum` and :py:meth:`core.groupby.DataArrayGroupBy.cumsum`.
@@ -133,7 +140,7 @@ New Features
- Expose the ``inline_array`` kwarg from :py:func:`dask.array.from_array` in :py:func:`open_dataset`,
:py:meth:`Dataset.chunk`, :py:meth:`DataArray.chunk`, and :py:meth:`Variable.chunk`. (:pull:`6471`)
By `Tom Nicholas `_.
-- :py:meth:`xr.polyval` now supports :py:class:`Dataset` and :py:class:`DataArray` args of any shape,
+- :py:func:`polyval` now supports :py:class:`Dataset` and :py:class:`DataArray` args of any shape,
is faster and requires less memory. (:pull:`6548`)
By `Michael Niklas `_.
- Improved overall typing.
@@ -166,7 +173,7 @@ Breaking changes
zarr 2.5 2.8
=============== ===== ====
-- The Dataset and DataArray ``rename*`` methods do not implicitly add or drop
+- The Dataset and DataArray ``rename```` methods do not implicitly add or drop
indexes. (:pull:`5692`).
By `Benoît Bovy `_.
- Many arguments like ``keep_attrs``, ``axis``, and ``skipna`` are now keyword
@@ -179,11 +186,6 @@ Breaking changes
(:pull:`6548`)
By `Michael Niklas `_.
-
-Deprecations
-~~~~~~~~~~~~
-
-
Bug fixes
~~~~~~~~~
@@ -211,8 +213,8 @@ Bug fixes
By `Stan West `_.
- Fix bug in :py:func:`where` when passing non-xarray objects with ``keep_attrs=True``. (:issue:`6444`, :pull:`6461`)
By `Sam Levang `_.
-- Allow passing both ``other`` and ``drop=True`` arguments to ``xr.DataArray.where``
- and ``xr.Dataset.where`` (:pull:`6466`, :pull:`6467`).
+- Allow passing both ``other`` and ``drop=True`` arguments to :py:meth:`DataArray.where`
+ and :py:meth:`Dataset.where` (:pull:`6466`, :pull:`6467`).
By `Michael Delgado `_.
- Ensure dtype encoding attributes are not added or modified on variables that contain datetime-like
values prior to being passed to :py:func:`xarray.conventions.decode_cf_variable` (:issue:`6453`,
@@ -220,7 +222,7 @@ Bug fixes
By `Spencer Clark `_.
- Dark themes are now properly detected in Furo-themed Sphinx documents (:issue:`6500`, :pull:`6501`).
By `Kevin Paul `_.
-- :py:meth:`isel` with `drop=True` works as intended with scalar :py:class:`DataArray` indexers.
+- :py:meth:`Dataset.isel`, :py:meth:`DataArray.isel` with `drop=True` works as intended with scalar :py:class:`DataArray` indexers.
(:issue:`6554`, :pull:`6579`)
By `Michael Niklas `_.
- Fixed silent overflow issue when decoding times encoded with 32-bit and below
@@ -236,10 +238,9 @@ Documentation
sizes. In particular, correct the syntax and replace lists with tuples in the
examples. (:issue:`6333`, :pull:`6334`)
By `Stan West `_.
-- Mention that ``xr.DataArray.rename`` can rename coordinates.
+- Mention that :py:meth:`DataArray.rename` can rename coordinates.
(:issue:`5458`, :pull:`6665`)
By `Michael Niklas `_.
-
- Added examples to :py:meth:`Dataset.thin` and :py:meth:`DataArray.thin`
By `Emma Marshall `_.
@@ -247,7 +248,7 @@ Performance
~~~~~~~~~~~
- GroupBy binary operations are now vectorized.
- Previously this involved looping over all groups. (:issue:`5804`,:pull:`6160`)
+ Previously this involved looping over all groups. (:issue:`5804`, :pull:`6160`)
By `Deepak Cherian `_.
- Substantially improved GroupBy operations using `flox `_.
This is auto-enabled when ``flox`` is installed. Use ``xr.set_options(use_flox=False)`` to use