show how to combine .tuples() and .iterate()
From the original description, it sounded like using .tuples(), .dicts() etc would imply .iterate(), which is not the case.
Explicitly state that for maximum performance you might want to do both, and show how you should do it.