Apply suggestions from code review

timhoffm · story645 · jklymak · web-flow · commit 39306cf92eb2 · 2023-07-27T16:58:17.000+02:00
Co-authored-by: hannah &lt;story645@gmail.com&gt;
Co-authored-by: Jody Klymak &lt;jklymak@gmail.com&gt;
diff --git a/lib/matplotlib/pylab.py b/lib/matplotlib/pylab.py
@@ -1,18 +1,16 @@
 """
-`pylab` is a historic interface that is no longer recommended.
+`pylab` is a historic interface and its use is now discouraged.
 
-Its original purpose was to mimic a MATLAB-like way of working by importing all
-functions into the global namespace.
-
-The intended usage pattern was ``from pylab import *``. This imports all functions
-from `matplotlib.pyplot`, `numpy`, `numpy.fft`, `numpy.linalg`, `numpy.random`, and
-some additional functions into the global namespace.
+Its original purpose was to support a MATLAB-like way of working by importing all
+functions into the global namespace. The intended usage pattern was ``from pylab 
+import *``. This imports all the functions from `matplotlib.pyplot`, `numpy`, `numpy.fft`, 
+`numpy.linalg`, and `numpy.random`, and some additional functions into the global namespace.
 
 .. warning::
-   The wildcard import will overwrite some builtin functions (e.g. the builtin `sum`
+   The wildcard import (`import *`) will overwrite some builtin functions (e.g. the builtin `sum`
    will be replaced by `numpy.sum`). This can lead to unexpected behavior.
 
-   The use of pylab is strongly discouraged. Use `matplotlib.pyplot` instead.
+   The use of pylab is strongly discouraged. Use `matplotlib.pyplot` instead.  See  :ref:` api_interfaces` for more detail.
 
 """
 
