dwca-export-controller documentation issues
Found in Version:
- the contoller method exportGetExplanation() which is mapped to
/dwcareturns an html page which will in future contain the documentation of the webservice. The documentation however is in general produced through swagger. Therefore this method seems to be a concurrent approach to produce webservice documentation. I advocate for removing this method and to add proper swagger annotations where needed.
- swagger annotations are at least need for all request parameters of the type
UuidList. All these appear as
List<String>in swagger, so the user does not know what to pass to the web service.
- Passing an invalid uuid as
classificationcauses a Error 400 Bad Request with no further information on the cause, better error reporting is neede here