Mention that find() doesn't consume the full iterator

It's useful to know this (opens up a bunch of other opportunities especially whilst parsing)
I think this should be "*Returns* the... " and "*Does* not consume..." (also both lines should end with a period).

Content-wise LGTM.