improved docs for means.rst