* reduce example script in leading code blocks
* explain services' API including freshly added events
* adding list of common sources for use in comparison tests of rules
* revising/adding examples