add missing page, add scatter as alias

py-polars/docs/source/reference/series/plot.rst

@@ -0,0 +1,7 @@
+====
+Plot
+====
+
+.. currentmodule:: polars
+
+.. autoproperty:: Series.plot

py-polars/polars/dataframe/frame.py

@@ -625,7 +625,8 @@ def plot(self) -> Plot:
           `alt.Chart(df).mark_line().encode(**kwargs).interactive()`
         - `df.plot.point(**kwargs)`
           is shorthand for
-          `alt.Chart(df).mark_point().encode(**kwargs).interactive()`
+          `alt.Chart(df).mark_point().encode(**kwargs).interactive()` (and `plot.scatter` is
+          provided as an alias)
         - `df.plot.bar(**kwargs)`
           is shorthand for
           `alt.Chart(df).mark_bar().encode(**kwargs).interactive()`

py-polars/polars/dataframe/plotting.py

@@ -251,6 +251,9 @@ def point(
             .interactive()
         )
 
+    # Alias to `point` because of how common it is.
+    scatter = point
+
     def __getattr__(self, attr: str) -> Callable[..., alt.Chart]:
         method = getattr(self.chart, f"mark_{attr}", None)
         if method is None:

py-polars/tests/unit/operations/namespaces/test_plot.py

@@ -23,6 +23,7 @@ def test_series_plot() -> None:
     s.plot.hist().to_json()
     s.plot.line().to_json()
     s.plot.point().to_json()
+    s.plot.scatter().to_json()
 
 
 def test_empty_dataframe() -> None: