CAL-103 [backport] Rest API documentation
CAL-411 Update comments for Calendar Service api