more consistent headers and explainations for plot types

story645 · story645 · commit f0333890334e · 2023-07-17T00:39:27.000-04:00
diff --git a/doc/sphinxext/gallery_order.py b/doc/sphinxext/gallery_order.py
@@ -38,8 +38,8 @@
 
 plot_types_order = [
     '../galleries/plot_types/basic',
-    '../galleries/plot_types/arrays',
     '../galleries/plot_types/stats',
+    '../galleries/plot_types/arrays',
     '../galleries/plot_types/unstructured',
     '../galleries/plot_types/3D',
     UNSORTED
diff --git a/galleries/plot_types/3D/README.rst b/galleries/plot_types/3D/README.rst
@@ -1,6 +1,7 @@
 .. _3D_plots:
 
-3D
---
+3D and volumetric data
+----------------------
 
-3D plots using the `mpl_toolkits.mplot3d` library.
+Plotting for three dimensional ``(x,y,z)`` and volumetric ``V(x,y,z)`` data
+using the `mpl_toolkits.mplot3d` library.
diff --git a/galleries/plot_types/README.rst b/galleries/plot_types/README.rst
@@ -5,8 +5,7 @@
 Plot types
 ==========
 
-Overview of many common plotting commands in Matplotlib.
+Overview of many common plotting commands provided by Matplotlib.
 
-Note that we have stripped all labels, but they are present by default.
-See the `gallery <../gallery/index.html>`_ for many more examples and
+See the `gallery <../gallery/index.html>`_ for more examples and
 the `tutorials page <../tutorials/index.html>`_ for longer examples.
diff --git a/galleries/plot_types/arrays/README.rst b/galleries/plot_types/arrays/README.rst
@@ -1,6 +1,6 @@
 .. _array_plots:
 
-Plots of arrays and fields
+Arrays, images, and fields
 --------------------------
 
-Plotting for arrays of data ``Z(x, y)`` and fields ``U(x, y), V(x, y)``.
+Plots of arrays and images ``Z(x, y)`` and fields ``U(x, y), V(x, y)``.
diff --git a/galleries/plot_types/basic/README.rst b/galleries/plot_types/basic/README.rst
@@ -1,6 +1,6 @@
 .. _basic_plots:
 
-Basic
------
+Tabular and linear data
+-----------------------
 
-Basic plot types, usually y versus x.
+Plots of items in a table ``(x, y)`` at index *i* and functional data ``f(x)=y``
diff --git a/galleries/plot_types/stats/README.rst b/galleries/plot_types/stats/README.rst
@@ -1,6 +1,6 @@
 .. _stats_plots:
 
-Statistics plots
-----------------
+Statistical Plots
+-----------------
 
-Plots for statistical analysis.
+Computation and plotting of distributions and other common statistical analysis.
diff --git a/galleries/plot_types/unstructured/README.rst b/galleries/plot_types/unstructured/README.rst
@@ -1,9 +1,7 @@
 .. _unstructured_plots:
 
-Unstructured coordinates
--------------------------
+Unstructured grids
+------------------
 
-Sometimes we collect data ``z`` at coordinates ``(x,y)`` and want to visualize
-as a contour.  Instead of gridding the data and then using
-`~.axes.Axes.contour`, we can use a triangulation algorithm and fill the
-triangles.
+Plots of data ``z`` at coordinates ``(x,y)`` on unstructured grids and plots of
+the unstructured grid.
