> Well, as a user / newcomer I wasted some time trying to figure out what was going on ..

I appreciate your feedback, this should not be. I'm with you.

> 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.

Maybe there is some misunderstanding. Reading events is fine as long as you did not save them before resampling.

>    Finding events in a decimating file is in general not easy. The recommended

Could we say something like: 

`You should never apply work with events on a decimated raw object that were computed before decimation. Please recompute your events after decimation.`

?