Problem description
The documentation in the API definition should be extended so, that no extra documentation is needed.

Expected action
Add documentation to API definition as discussed in camaraproject/WorkingGroups#164

Additional context