Improve OpenAPI documentation

Taskana / taskana

Lightweight library for general purpose task management

https://taskana.pro

Apache License 2.0

92 stars 100 forks source link

Open holgerhagen opened 2 months ago

holgerhagen commented 2 months ago

Areas for improvement

not all return codes are documented (actually just a few)
Are the listed return coded upfront still helpful (in combination with the bullet point above)
Sometimes the HATEOAS links look weird in the docs and blow the examples up.
make required values more visible