Updated docs to reflect a pagination bug that was fixed. Closes: issue #6068

Closes https://github.com/pydata/pandas/issues/6096