DOC: boxplot docs do not explain what the plot shows at all

[keszybz]

Extensive documentation is probably not needed, but at a minimum, the docstring should say

• what the red line is (median)
• what the box shows (quartiles)
• what the whiskers show (?)
• by what rules the outliers are shown or not

A link to wikipedia and/or matplotlib docs would be nice too.

I could try to contribute this, if it is deemed useful.

[TomAugspurger]

Sure thing. Feel free to submit a pull request. I think a sentence saying what each element is and a link to the matplotlib docs should suffice.

[Tych0n]

Hi! Do whiskers show +-1.5IQ? Cause i have asymmetrical whiskers:

P.S. For future generations. As TomAugspurger mentioned, whiskers are not the ±x(1.5 by default)*IQR limits, but the values of boundary data points within these intervals.

[TomAugspurger]

A link to https://matplotlib.org/api/_as_gen/matplotlib.axes.Axes.boxplot.html#matplotlib-axes-axes-boxplot would explain that the whiskers show:

In other words, where IQR is the interquartile range (Q3-Q1), the upper whisker will extend to last datum less than Q3 + whisIQR). Similarly, the lower whisker will extend to the first datum greater than Q1 - whisIQR.