Well, as a user / newcomer I wasted some time trying to figure out what was going on, so I thought that expanding the docstring would be useful. I think what you're basically saying is that read_events should be deprecated, which is fine, but as long as it exists it would be nice if users understand what it does.