Document the event interface

This request adds documentation about the event mechanism.  It includes documentation on the new "save" respec event that is introduced in the ReSpec pull request 335 - so it should only be merged when/if that pull request is merged.

https://github.com/w3c/respec/pull/335