diff --git a/galleries/examples/lines_bars_and_markers/categorical_variables.py b/galleries/examples/lines_bars_and_markers/categorical_variables.py
index 4cceb38fbd4d..a19a30eda2b2 100644
--- 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"]