DOC: add whats new entry

tacaswell · tacaswell · commit a724652f3d28 · 2022-12-08T18:54:13.000-05:00
diff --git a/doc/users/next_whats_new/per_subplot_mosaic.rst b/doc/users/next_whats_new/per_subplot_mosaic.rst
@@ -0,0 +1,22 @@
+Per-subplot keyword arguments  in ``subplot_mosaic``
+----------------------------------------------------
+
+It is now possible to pass keyword arguments through to the creation to each
+specific call to ``add_subplot`` in `.Figure.subplot_mosaic` and
+`.pyplot.subplot_mosaic` :
+
+.. plot::
+   :include-source: true
+
+   fig, axd = plt.subplot_mosaic(
+       "AB;CD",
+       per_subplot_kw={
+           "A": {"projection": "polar"},
+           ("C", "D"): {"xlabel": "X Label"},
+           "B": {"projection": "3d"},
+       },
+   )
+
+
+This is particularly useful for creating mosaics with mixed projections, but
+any keyword arguments can be passed through.
