DOC refer to plot in the scatter plot doc

NelleV · NelleV · commit 88737e27b672 · 2016-09-12T10:32:57.000-07:00
Encourage users to use plot instead of scatter when all markers are identical in size and colour. Closes #7083
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -3889,17 +3889,25 @@ def scatter(self, x, y, s=None, c=None, marker=None, cmap=None, norm=None,
         ----------------
         kwargs : `~matplotlib.collections.Collection` properties
 
+        See Also
+        --------
+        plot : to plot scatter plots when markers are identical in size and
+            color
+
         Notes
-        ------
-        Any or all of `x`, `y`, `s`, and `c` may be masked arrays, in
-        which case all masks will be combined and only unmasked points
-        will be plotted.
+        -----
+
+        * When attempting to plot a scatter plots where markers don't vary in
+          size and color, the `plot` function will be faster.
+
+        * Any or all of `x`, `y`, `s`, and `c` may be masked arrays, in which
+          case all masks will be combined and only unmasked points will be
+          plotted.
 
-        Fundamentally, scatter works with 1-D arrays; `x`, `y`, `s`,
-        and `c` may be input as 2-D arrays, but within scatter
-        they will be flattened. The exception is `c`, which
-        will be flattened only if its size matches the size of `x`
-        and `y`.
+          Fundamentally, scatter works with 1-D arrays; `x`, `y`, `s`, and `c`
+          may be input as 2-D arrays, but within scatter they will be
+          flattened. The exception is `c`, which will be flattened only if its
+          size matches the size of `x` and `y`.
 
         Examples
         --------
