Docstring wording

timhoffm · timhoffm · commit 8cf06c487882 · 2025-06-02T15:50:41.000+02:00
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -3041,16 +3041,17 @@ def grouped_bar(self, heights, *, positions=None, group_spacing=1.5, bar_spacing
 
         .. versionadded:: 3.11
 
-            This function is new in v3.11, and the API is still provisional.
-            We may still fine-tune some aspects based on user-feedback.
-
-        Grouped bar charts visualize a collection of multiple categorical datasets.
-        A categorical dataset is a mapping *name* -> *value*. The values of the
-        dataset are represented by a sequence of bars of the same color.
-        In a grouped bar chart, the bars of all datasets are grouped together by
-        category. The category names are drawn as tick labels next to the bar group.
-        Each dataset has a distinct bar color, and can optionally get a label that
-        is used for the legend.
+            The API is still provisional. We may still fine-tune some aspects based on
+            user-feedback.
+
+        Grouped bar charts visualize a collection of categorical datasets. Each value
+        in a dataset belongs to a distinct category and these categories are the same
+        across all datasets. The categories typically have string names, but could
+        also be dates or index keys. The values in each dataset are represented by a
+        sequence of bars of the same color. The bars of all datasets are grouped
+        together by their shared categories. The category names are drawn as the tick
+        labels for each bar group. Each dataset has a distinct bar color, and can
+        optionally get a label that is used for the legend.
 
         Example:
 
