Use plot directive in What's New entry

lucaznch · lucaznch · commit 6119192ba351 · 2026-04-10T22:30:26.000+01:00
diff --git a/doc/release/next_whats_new/pcolormesh_gouraud.rst b/doc/release/next_whats_new/pcolormesh_gouraud.rst
@@ -19,8 +19,11 @@ Shading can be switched for the same data location, allowing
 switches between ``nearest`` and ``gouraud``, and now also
 between ``flat`` and ``gouraud``.
 
-For example::
+For example:
 
+.. plot::
+    :include-source: true
+    :alt: Switching between constant and linearly interpolated shading for data at corners and centers.
 
     import matplotlib.pyplot as plt
     import numpy as np
@@ -30,12 +33,20 @@ For example::
     x = np.arange(ncols + 1)
     y = np.arange(nrows + 1)
 
-    fig, ax = plt.subplots()
+    fig, axs = plt.subplots(2, 2, layout='constrained')
 
-    # Data at corners, requires X and Y one larger than Z.
-    ax.pcolormesh(x, y, Z, shading='flat')
-    ax.pcolormesh(x, y, Z, shading='gouraud')
+    # Data at corners, requires X and Y the same shape as Z.
+    axs[0, 0].pcolormesh(x[:-1], y[:-1], Z, shading='nearest')
+    axs[0, 0].set_title('nearest: X, Y, Z same shape')
 
-    # Data at centers, requires X and Y the same shape as Z.
-    ax.pcolormesh(x[:-1], y[:-1], Z, shading='nearest')
-    ax.pcolormesh(x[:-1], y[:-1], Z, shading='gouraud')
+    axs[0, 1].pcolormesh(x[:-1], y[:-1], Z, shading='gouraud')
+    axs[0, 1].set_title('gouraud: X, Y, Z same shape')
+
+    # Data at centers, requires X and Y one larger than Z.
+    axs[1, 0].pcolormesh(x, y, Z, shading='flat')
+    axs[1, 0].set_title('flat: X, Y one larger than Z')
+
+    axs[1, 1].pcolormesh(x, y, Z, shading='gouraud')
+    axs[1, 1].set_title('gouraud: X, Y one larger than Z')
+
+    plt.show()
