Adding a rough doc describing how the event system does/should work

Some is implemented, other parts are dev plan, and they're not
separated. This is more like the "design doc" that previously existed
only in my brain.