Apply suggestions from code review

rcomer · timhoffm · web-flow · commit 7417870b8691 · 2025-11-11T18:50:36.000Z
Co-authored-by: Tim Hoffmann &lt;2836374+timhoffm@users.noreply.github.com&gt;
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -3755,7 +3755,7 @@ def get_next_color():
 
         return pc
 
-    def pie_label(self, container, labels, *, distance=0.6,
+    def pie_label(self, container, /, labels, *, distance=0.6,
                   textprops=None, rotate=False, alignment='auto'):
         """
         Label a pie chart.
@@ -3825,7 +3825,8 @@ def pie_label(self, container, labels, *, distance=0.6,
                 # escape % (i.e. \%) if it is not already escaped
                 labels = [re.sub(r"([^\\])%", r"\1\\%", s) for s in labels]
         elif (nw := len(container.wedges)) != (nl := len(labels)):
-            raise ValueError(f'Found {nw} wedges but {nl} labels')
+            raise ValueError(
+                f'The number of labels ({nl}) must match the number of wedges ({nw})')
 
         texts = []
 
diff --git a/lib/matplotlib/container.py b/lib/matplotlib/container.py
@@ -154,8 +154,9 @@ class PieContainer:
 
     .. versionadded:: 3.11
 
-    The ``PieContainer`` name is provisional and may change in future to reflect
-    development of its functionality.
+    .. warning::
+        The class name ``PieContainer`` name is provisional and may change in future
+        to reflect development of its functionality.
 
     You can access the wedge patches and further parameters by the attributes.
 
