SAMZA-176: Improve docs for MessageCollector. Reviewed by Jakob Homan.