built-in accessor documentation

doc/api.rst

@@ -667,17 +667,17 @@ Plotting
    :toctree: generated/
 
    Dataset.plot
-   plot.scatter
-   DataArray.plot
+   Dataset.plot.scatter
    plot.plot
-   plot.contourf
-   plot.contour
-   plot.hist
-   plot.imshow
-   plot.line
-   plot.pcolormesh
-   plot.step
-   plot.FacetGrid
+   DataArray.plot
+   DataArray.plot.contourf
+   DataArray.plot.contour
+   DataArray.plot.hist
+   DataArray.plot.imshow
+   DataArray.plot.line
+   DataArray.plot.pcolormesh
+   DataArray.plot.step
+
 
 Faceting
 --------

xarray/core/dataarray.py

@@ -2680,7 +2680,7 @@ def func(self, other):
     def _copy_attrs_from(self, other: Union["DataArray", Dataset, Variable]) -> None:
         self.attrs = other.attrs
 
-    @property
+    @utils.property_
     def plot(self) -> _PlotMethods:
         """
         Access plotting functions for DataArray's

xarray/core/dataset.py

@@ -5551,7 +5551,7 @@ def real(self):
     def imag(self):
         return self._unary_op(lambda x: x.imag, keep_attrs=True)(self)
 
-    @property
+    @utils.property_
     def plot(self):
         """
         Access plotting functions for Datasets.

xarray/core/utils.py

@@ -787,6 +787,16 @@ def drop_dims_from_indexers(
         )
 
 
+class property_:
+    """ Acts like a property, but on both classes and class instances """
+
+    def __init__(self, func):
+        self._func = func
+
+    def __get__(self, obj, cls):
+        return self._func(obj)
+
+
 # Singleton type, as per https://github.com/python/typing/pull/240
 class Default(Enum):
     token = 0

xarray/plot/plot.py

@@ -438,7 +438,7 @@ class _PlotMethods:
     For example, DataArray.plot.imshow
     """
 
-    __slots__ = ("_da",)
+    # __slots__ = ("_da",)
 
     def __init__(self, darray):
         self._da = darray