diff --git a/doc/installing.rst b/doc/installing.rst
index dfc2841a956..a25bf65e342 100644
--- a/doc/installing.rst
+++ b/doc/installing.rst
@@ -11,6 +11,8 @@ Required dependencies
- `numpy `__ (1.15 or later)
- `pandas `__ (0.25 or later)
+.. _optional-dependencies:
+
Optional dependencies
---------------------
@@ -24,7 +26,7 @@ For netCDF and IO
- `h5netcdf `__: an alternative library for
reading and writing netCDF4 files that does not use the netCDF-C libraries
- `pynio `__: for reading GRIB and other
- geoscience specific file formats
+ geoscience specific file formats. Note that pynio is not available for Windows.
- `zarr `__: for chunked, compressed, N-dimensional arrays.
- `cftime `__: recommended if you
want to encode/decode datetimes for non-standard calendars or dates before
@@ -121,16 +123,15 @@ xarray itself is a pure Python package, but its dependencies are not. The
easiest way to get everything installed is to use conda_. To install xarray
with its recommended dependencies using the conda command line tool::
- $ conda install xarray dask netCDF4 bottleneck
+ $ conda install -c conda-forge xarray dask netCDF4 bottleneck
.. _conda: http://conda.io/
-We recommend using the community maintained `conda-forge `__ channel if you need difficult\-to\-build dependencies such as cartopy, pynio or PseudoNetCDF::
-
- $ conda install -c conda-forge xarray cartopy pynio pseudonetcdf
+If you require other :ref:`optional-dependencies` add them to the line above.
-New releases may also appear in conda-forge before being updated in the default
-channel.
+We recommend using the community maintained `conda-forge `__ channel,
+as some of the dependencies are difficult to build. New releases may also appear in conda-forge before
+being updated in the default channel.
If you don't use conda, be sure you have the required dependencies (numpy and
pandas) installed first. Then, install xarray with pip::
diff --git a/doc/whats-new.rst b/doc/whats-new.rst
index 00c63b81260..3f04ba4ec57 100644
--- a/doc/whats-new.rst
+++ b/doc/whats-new.rst
@@ -81,6 +81,9 @@ Documentation
- Fix documentation of :py:class:`DataArray` removing the deprecated mention
that when omitted, `dims` are inferred from a `coords`-dict. (:pull:`3821`)
By `Sander van Rijn `_.
+- Update the installation instructions: only explicitly list recommended dependencies
+ (:issue:`3756`).
+ By `Mathias Hauser `_.
Internal Changes
~~~~~~~~~~~~~~~~