fix typos
polish up Event Trigger documentation
major clean-up

* more consistency
* less uncertainty
* corrected mistakes and clarified some things