Since Swagger was reintroduced in CDS the Swagger annotations need to be updated. All API classes should be updated to make them ready for publishing the API Reference in Read The Docs.

Points to take care of:

• descriptions of the API and endpoints
• sample requests/responses
• models used
• parameter description