docs(python): mark .plot property as unstable (#17205)

py-polars/polars/dataframe/frame.py

@@ -563,10 +563,15 @@ def _replace(self, column: str, new_column: Series) -> DataFrame:
         return self
 
     @property
+    @unstable()
     def plot(self) -> hvPlotTabularPolars:
         """
         Create a plot namespace.
 
+        .. warning::
+            This functionality is currently considered **unstable**. It may be
+            changed at any point without it being considered a breaking change.
+
         Polars does not implement plotting logic itself, but instead defers to
         hvplot. Please see the `hvplot reference gallery <https://hvplot.holoviz.org/reference/index.html>`_
         for more information and documentation.

py-polars/polars/series/series.py

@@ -7305,10 +7305,15 @@ def struct(self) -> StructNameSpace:
         return StructNameSpace(self)
 
     @property
+    @unstable()
     def plot(self) -> hvPlotTabularPolars:
         """
         Create a plot namespace.
 
+        .. warning::
+            This functionality is currently considered **unstable**. It may be
+            changed at any point without it being considered a breaking change.
+
         Polars does not implement plotting logic itself, but instead defers to
         hvplot. Please see the `hvplot reference gallery <https://hvplot.holoviz.org/reference/index.html>`_
         for more information and documentation.