Doc for GH 8946

For https://github.com/pydata/pandas/pull/8946
you are right, will push an update in a minute...