Add swap_coords to relevant 'See also' sections

Author: nedclimaterisk

xarray/core/common.py

@@ -344,6 +344,7 @@ def assign_coords(self, **kwargs):
         See also
         --------
         Dataset.assign
+        Dataset.swap_coords
         """
         data = self.copy(deep=False)
         results = self._calc_assign_results(kwargs)

xarray/core/dataset.py

@@ -1112,6 +1112,10 @@ def set_coords(self, names, inplace=False):
         Returns
         -------
         Dataset
+
+        See also
+        --------
+        Dataset.swap_coords
         """
         # 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_coords
         """
         indexes = either_dict_or_kwargs(indexes, indexes_kwargs, 'set_index')
         variables, coord_names = merge_indexes(indexes, self._variables,

xarray/core/groupby.py

@@ -423,6 +423,7 @@ def assign_coords(self, **kwargs):
         See also
         --------
         Dataset.assign_coords
+        Dataset.swap_coords
         """
         return self.apply(lambda ds: ds.assign_coords(**kwargs))