[DOCS-2817] [DOCS-2819] Document `flatten()` pagination fn

[jrodewig]

Ticket(s): DOCS-2817, DOCS-2819

• Documents the flatten() method for pagination
• Removes class names from method references in text. This aligns with Google's style recommendations. A user was recently confused by it. (ref)

---

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.