update: Event Specification
add: Entities documentation ; improve: REST API documentation