Improve docs for IterableContainerFactory

It's one of the more complex classes, so try to make it a bit easier to
understand.