diff --git a/doc/Makefile b/doc/Makefile
index 35ca3a44e5d..fd9305be04e 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -2,7 +2,7 @@
#
# You can set these variables from the command line.
-SPHINXOPTS =
+SPHINXOPTS = -T -W --keep-going -j auto
SPHINXBUILD = sphinx-build
SPHINXATUOBUILD = sphinx-autobuild
PAPER =
diff --git a/doc/api-hidden.rst b/doc/api-hidden.rst
index 9f56fca1472..cabca85cdbc 100644
--- a/doc/api-hidden.rst
+++ b/doc/api-hidden.rst
@@ -421,7 +421,6 @@
CFTimeIndex.factorize
CFTimeIndex.fillna
CFTimeIndex.floor
- CFTimeIndex.format
CFTimeIndex.get_indexer
CFTimeIndex.get_indexer_for
CFTimeIndex.get_indexer_non_unique
@@ -430,18 +429,10 @@
CFTimeIndex.get_slice_bound
CFTimeIndex.get_value
CFTimeIndex.groupby
- CFTimeIndex.holds_integer
CFTimeIndex.identical
CFTimeIndex.insert
CFTimeIndex.intersection
CFTimeIndex.is_
- CFTimeIndex.is_boolean
- CFTimeIndex.is_categorical
- CFTimeIndex.is_floating
- CFTimeIndex.is_integer
- CFTimeIndex.is_interval
- CFTimeIndex.is_numeric
- CFTimeIndex.is_object
CFTimeIndex.isin
CFTimeIndex.isna
CFTimeIndex.isnull
@@ -465,7 +456,6 @@
CFTimeIndex.shift
CFTimeIndex.slice_indexer
CFTimeIndex.slice_locs
- CFTimeIndex.sort
CFTimeIndex.sort_values
CFTimeIndex.sortlevel
CFTimeIndex.strftime
diff --git a/doc/contribute/contributing.rst b/doc/contribute/contributing.rst
index ae8cbc246a9..58eebf2b59d 100644
--- a/doc/contribute/contributing.rst
+++ b/doc/contribute/contributing.rst
@@ -245,6 +245,7 @@ You can either run pre-commit manually via Pixi as described above, or set up gi
This is done by:
.. code-block:: sh
+
pixi shell -e pre-commit # enter the pre-commit environment
pre-commit install # install the git hooks
diff --git a/doc/user-guide/duckarrays.rst b/doc/user-guide/duckarrays.rst
index efae5f2d755..2e3ee5936e7 100644
--- a/doc/user-guide/duckarrays.rst
+++ b/doc/user-guide/duckarrays.rst
@@ -16,7 +16,7 @@ Some numpy-like array types that xarray already has some support for:
* `Sparse `_ - for performant arrays with many zero elements,
* `Pint `_ - for tracking the physical units of your data (see `pint-xarray `_),
* `Dask `_ - parallel computing on larger-than-memory arrays (see :ref:`using dask with xarray `),
-* `Cubed `_ - another parallel computing framework that emphasises reliability (see `cubed-xarray `_).
+* `Cubed `_ - another parallel computing framework that emphasises reliability (see `cubed-xarray`_).
.. warning::
@@ -231,4 +231,6 @@ easier. If you know of more that aren't on this list please raise an issue to ad
- `pint-xarray `_
- `cupy-xarray `_
-- `cubed-xarray `_
+- `cubed-xarray`_
+
+.. _cubed-xarray: https://github.com/cubed-dev/cubed-xarray
diff --git a/doc/user-guide/plotting.rst b/doc/user-guide/plotting.rst
index 6d45130611e..eb3567ccbdf 100644
--- a/doc/user-guide/plotting.rst
+++ b/doc/user-guide/plotting.rst
@@ -212,7 +212,7 @@ from the time and assign it as a non-dimension coordinate:
.. jupyter-execute::
- decimal_day = (air1d.time - air1d.time[0]) / pd.Timedelta("1d")
+ decimal_day = (air1d.time - air1d.time[0]) / pd.Timedelta("1D")
air1d_multi = air1d.assign_coords(decimal_day=("time", decimal_day.data))
air1d_multi
diff --git a/xarray/computation/computation.py b/xarray/computation/computation.py
index 85f9ed672a4..3df468f19a9 100644
--- a/xarray/computation/computation.py
+++ b/xarray/computation/computation.py
@@ -696,6 +696,7 @@ def where(cond, x, y, keep_attrs=None):
y : scalar, array, Variable, DataArray or Dataset
values to choose from where `cond` is False
keep_attrs : bool or {"drop", "identical", "no_conflicts", "drop_conflicts", "override"} or callable, optional
+
- 'override' or True (default): skip comparing and copy attrs from `x` to the result.
- 'drop' or False: empty attrs on returned xarray object.
- 'identical': all attrs must be the same on every object.
@@ -734,6 +735,7 @@ def where(cond, x, y, keep_attrs=None):
standard_name: sea_surface_temperature
If `x` is a scalar then by default there are no attrs on the result
+
>>> xr.where(x < 0.5, 1, 0)
Size: 80B
array([1, 1, 1, 1, 1, 0, 0, 0, 0, 0])
@@ -742,6 +744,7 @@ def where(cond, x, y, keep_attrs=None):
If `x` is a scalar (and therefore has no attrs), preserve the
attrs on `cond` by using `keep_attrs="drop_conflicts"`
+
>>> xr.where(x < 0.5, 1, 0, keep_attrs="drop_conflicts")
Size: 80B
array([1, 1, 1, 1, 1, 0, 0, 0, 0, 0])