Docs: adjust formatting and flow of event and report endpoints
Merge pull request #458 from cprice-puppet/maint/master/cherry-pick-event-api-docs-fix

Docs: adjust formatting and flow of event and report endpoints