From a4a2f567601dcac4ff127c29ca801dc9e148cbf8 Mon Sep 17 00:00:00 2001
From: ned haughton <ned@climaterisk.com.au>
Date: Thu, 4 Oct 2018 19:56:42 +1000
Subject: [PATCH] Add swap_dims to relevant 'See also' sections

---
 xarray/core/common.py  | 1 +
 xarray/core/dataset.py | 5 +++++
 xarray/core/groupby.py | 1 +
 3 files changed, 7 insertions(+)

diff --git a/xarray/core/common.py b/xarray/core/common.py
index 41e4fec2982..fff065c6875 100644
--- a/xarray/core/common.py
+++ b/xarray/core/common.py
@@ -344,6 +344,7 @@ def assign_coords(self, **kwargs):
         See also
         --------
         Dataset.assign
+        Dataset.swap_dims
         """
         data = self.copy(deep=False)
         results = self._calc_assign_results(kwargs)
diff --git a/xarray/core/dataset.py b/xarray/core/dataset.py
index 5e787c1587b..6355b2f6c22 100644
--- a/xarray/core/dataset.py
+++ b/xarray/core/dataset.py
@@ -1112,6 +1112,10 @@ def set_coords(self, names, inplace=False):
         Returns
         -------
         Dataset
+
+        See also
+        --------
+        Dataset.swap_dims
         """
         # TODO: allow inserting new coordinates with this method, like
         # DataFrame.set_index?
@@ -2297,6 +2301,7 @@ def set_index(self, indexes=None, append=False, inplace=False,
         See Also
         --------
         Dataset.reset_index
+        Dataset.swap_dims
         """
         indexes = either_dict_or_kwargs(indexes, indexes_kwargs, 'set_index')
         variables, coord_names = merge_indexes(indexes, self._variables,
diff --git a/xarray/core/groupby.py b/xarray/core/groupby.py
index 3842c642047..dc23eae8b76 100644
--- a/xarray/core/groupby.py
+++ b/xarray/core/groupby.py
@@ -423,6 +423,7 @@ def assign_coords(self, **kwargs):
         See also
         --------
         Dataset.assign_coords
+        Dataset.swap_dims
         """
         return self.apply(lambda ds: ds.assign_coords(**kwargs))