Document orchestration event list API

This change adds API documetation for event list,
also this change that as part of blueprint
events-pagination.

Change-Id: I2a8e9f1bc29b8d5a6a4533d24e1a2cd324461e35
Closes-Bug: #1347442
Merge "Document orchestration event list API"