jbrockmendel DOC: docstring, closes pandas-dev#23475 (pandas-dev#34619)