diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
index 2e1c59fd5ea6..9037674780e2 100644
--- a/lib/matplotlib/axes/_axes.py
+++ b/lib/matplotlib/axes/_axes.py
@@ -2950,6 +2950,8 @@ def errorbar(self, x, y, yerr=None, xerr=None,
                 upper errors.
             - *None*: No errorbar.
 
+            Note that all error arrays should have *positive* values.
+
             See :doc:`/gallery/statistics/errorbar_features`
             for an example on the usage of ``xerr`` and ``yerr``.