Backport PR #29601: DOC: Duplicate catergorial values are mapped to the same position

story645 · meeseeksmachine · commit 71dd07bd3b02 · 2025-02-11T18:54:46.000Z
diff --git a/galleries/examples/lines_bars_and_markers/categorical_variables.py b/galleries/examples/lines_bars_and_markers/categorical_variables.py
@@ -20,7 +20,10 @@
 
 
 # %%
-# This works on both Axes:
+# Categorical values are a mapping from names to positions. This means that
+# values that occur multiple times are mapped to the same position. See the
+# ``cat`` and ``dog`` values "happy" and "bored" on the y-axis in the following
+# example.
 
 cat = ["bored", "happy", "bored", "bored", "happy", "bored"]
 dog = ["happy", "happy", "happy", "happy", "bored", "bored"]
