Document that iterable side effects fallback to return value when exhausted

[lundberg]

Might not be obvious, but this works exactly like unittest mock. Doesn't hurt to make a note in the docs about this api usage.