update the documentation links

Missing: section links in visualization_gallery.ipynb don't work yet,
also the one in io.rst (it has a unicode char).

doc/data-structures.rst

@@ -485,14 +485,14 @@ in xarray:
   :py:class:`pandas.Index` internally to store their values.
 
 - **non-dimension coordinates** are variables that contain coordinate
-  data, but are not a dimension coordinate. They can  be multidimensional
-  (see :ref:`examples.multidim`), and there is no relationship between the
-  name of a non-dimension coordinate and the name(s) of its dimension(s).
-  Non-dimension coordinates can be useful for indexing or plotting; otherwise,
-  xarray does not make any direct use of the values associated with them.
-  They are not used for alignment or automatic indexing, nor are they required
-  to match when doing arithmetic
-  (see :ref:`coordinates math`).
+  data, but are not a dimension coordinate. They can be multidimensional (see
+  :ref:`/examples/multidimensional-coords.ipynb`), and there is no
+  relationship between the name of a non-dimension coordinate and the
+  name(s) of its dimension(s).  Non-dimension coordinates can be
+  useful for indexing or plotting; otherwise, xarray does not make any
+  direct use of the values associated with them.  They are not used
+  for alignment or automatic indexing, nor are they required to match
+  when doing arithmetic (see :ref:`coordinates math`).
 
 .. note::
 

doc/io.rst

@@ -735,8 +735,8 @@ The ``x`` and ``y`` coordinates are generated out of the file's metadata
 (``bounds``, ``width``, ``height``), and they can be understood as cartesian
 coordinates defined in the file's projection provided by the ``crs`` attribute.
 ``crs`` is a PROJ4 string which can be parsed by e.g. `pyproj`_ or rasterio.
-See :ref:`recipes.rasterio` for an example of how to convert these to
-longitudes and latitudes.
+See :ref:`/examples/visualization_gallery.ipynb#Parsing-rasterio%u2019s-geocoordinates`
+for an example of how to convert these to longitudes and latitudes.
 
 .. warning::
 

doc/plotting.rst

@@ -782,7 +782,7 @@ coordinates.
 Multidimensional coordinates
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-See also: :ref:`examples.multidim`.
+See also: :ref:`/examples/multidimensional-coords.ipynb`.
 
 You can plot irregular grids defined by multidimensional coordinates with
 xarray, but you'll have to tell the plot function to use these coordinates

doc/whats-new.rst

@@ -2781,7 +2781,7 @@ Enhancements
 - Groupby operations now support grouping over multidimensional variables. A new
   method called :py:meth:`~xarray.Dataset.groupby_bins` has also been added to
   allow users to specify bins for grouping. The new features are described in
-  :ref:`groupby.multidim` and :ref:`examples.multidim`.
+  :ref:`groupby.multidim` and :ref:`/examples/multidimensional-coords.ipynb`.
   By `Ryan Abernathey <https://github.com/rabernat>`_.
 
 - DataArray and Dataset method :py:meth:`where` now supports a ``drop=True``
@@ -3846,7 +3846,7 @@ Enhancements
 - Long attributes are now truncated at 500 characters when printing a dataset
   (:issue:`338`). This should make things more convenient for working with
   datasets interactively.
-- Added a new documentation example, :ref:`monthly means example`. Thanks Joe
+- Added a new documentation example, :ref:`/examples/monthly-means.ipynb`. Thanks Joe
   Hamman!
 
 Bug fixes