The help for this function doesn't really describe what the function is supposed to do.
pcolormesh(X, Y, C)
*C* may be a masked array, but *X* and *Y* may not. Masked
array support is implemented via *cmap* and *norm*; in
contrast, :func:`~matplotlib.pyplot.pcolor` simply does not
draw quadrilaterals with masked colors or vertices.
I agree completely.
There is a guide on how to contribute to the documentation (http://matplotlib.sourceforge.net/faq/howto_faq.html#contribute-to-matplotlib-documentation), but if you don't feel comfortable submitting a patch then please update this issue with the text you would like to see and I would be happy to make a pull request for you.
I have noted this and will be updating the docstring at some point.
closed by #1082