mare improvements to docs for Iterable