DOC: Clarify interface terminology

timhoffm · timhoffm · commit 15a88dbb54fc · 2024-04-05T01:08:47.000+02:00
as proposed in https://github .com//issues/21817#issuecomment-983705359 and #26388 and already used in 26402. Closes #21817.
diff --git a/doc/devel/style_guide.rst b/doc/devel/style_guide.rst
@@ -155,14 +155,18 @@ reliability and consistency in documentation. They are not interchangeable.
   |                  |                          |   rotational |              |
   |                  |                          |   motion."   |              |
   +------------------+--------------------------+--------------+--------------+
-  | Explicit,        | Explicit approach of     | - Explicit   | - object     |
-  | Object Oriented  | programming in           | - explicit   |   oriented   |
-  | Programming (OOP)| Matplotlib.              | - OOP        | - OO-style   |
+  | Axes interface   | Usage pattern in which   | - Axes       | - explicit   |
+  |                  | one calls methods on     |   interface  |   interface  |
+  |                  | Axes and Figure to       | - call       | - object     |
+  |                  | configure the plot.      |   methods on |   oriented   |
+  |                  |                          |   the Axes   | - OO-style   |
+  |                  |                          |   object     | - OOP        |
   +------------------+--------------------------+--------------+--------------+
-  | Implicit,        | Implicit approach of     | - Implicit   | - MATLAB like|
-  | ``pyplot``       | programming in Matplotlib| - implicit   | - Pyplot     |
-  |                  | with ``pyplot`` module.  | - ``pyplot`` | - pyplot     |
-  |                  |                          |              |   interface  |
+  | pyplot interface | Usage pattern in which   | - ``pyplot`` | - implicit   |
+  |                  | one calls `.pyplot`      |   interface  |   interface  |
+  |                  | functions only to with   | - call       | - MATLAB like|
+  |                  | configure the plot.      |   ``pyplot`` | - Pyplot     |
+  |                  |                          |   functions  |              |
   +------------------+--------------------------+--------------+--------------+
 
 .. |Figure| replace:: :class:`~matplotlib.figure.Figure`
