SI-8215: Document IllegalStateExceptions thrown by uninitialized MatchIterator from Regex (review by @heathermiller)

Also cleans up a misaligned ASCII art class diagram which is duplicated by the Content Hierarchy anyway.

See https://groups.google.com/forum/#!topic/scala-language/2T2wKVQiyVg