@@ -3075,16 +3075,17 @@ def grouped_bar(self, heights, *, positions=None, group_spacing=1.5, bar_spacing
3075
3075
3076
3076
.. versionadded:: 3.11
3077
3077
3078
- This function is new in v3.11, and the API is still provisional.
3079
- We may still fine-tune some aspects based on user-feedback.
3080
-
3081
- Grouped bar charts visualize a collection of multiple categorical datasets.
3082
- A categorical dataset is a mapping *name* -> *value*. The values of the
3083
- dataset are represented by a sequence of bars of the same color.
3084
- In a grouped bar chart, the bars of all datasets are grouped together by
3085
- category. The category names are drawn as tick labels next to the bar group.
3086
- Each dataset has a distinct bar color, and can optionally get a label that
3087
- is used for the legend.
3078
+ The API is still provisional. We may still fine-tune some aspects based on
3079
+ user-feedback.
3080
+
3081
+ Grouped bar charts visualize a collection of categorical datasets. Each value
3082
+ in a dataset belongs to a distinct category and these categories are the same
3083
+ across all datasets. The categories typically have string names, but could
3084
+ also be dates or index keys. The values in each dataset are represented by a
3085
+ sequence of bars of the same color. The bars of all datasets are grouped
3086
+ together by their shared categories. The category names are drawn as the tick
3087
+ labels for each bar group. Each dataset has a distinct bar color, and can
3088
+ optionally get a label that is used for the legend.
3088
3089
3089
3090
Example:
3090
3091