diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 5325f50a4d37..a96ffafe0e08 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -3812,8 +3812,9 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None,
                 verts=None, edgecolors=None,
                 **kwargs):
         """
-        Make a scatter plot of x vs y, where x and y are sequence like objects
-        of the same length.
+        Make a scatter plot of `x` vs `y`
+
+        Marker size is scaled by `s` and marker color is mapped to `c`
 
         Parameters
         ----------
@@ -3861,6 +3862,12 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None,
         linewidths : scalar or array_like, optional, default: None
             If None, defaults to (lines.linewidth,).
 
+        verts : sequence of (x, y), optional
+            If `marker` is None, these vertices will be used to
+            construct the marker.  The center of the marker is located
+            at (0,0) in normalized units.  The overall marker is rescaled
+            by ``s``.
+
         edgecolors : color or sequence of color, optional, default: None
             If None, defaults to 'face'