I've cleaned up and documented the events plugin, it's close to being ready for 1.0.