Doc for GH 8946

For https://github.com/pydata/pandas/pull/8946