Actions
action #177708
opencoordination #154768: [saga][epic][ux] State-of-art user experience for openQA
coordination #154771: [epic] Improved test developer user experience
documentation: Better API documentation, e.g. with openAPI
Start date:
2017-01-27
Due date:
% Done:
0%
Estimated time:
Description
User story¶
As an openQA API user I want documentation of available API commands in easier to read format so that I am motivated to use the API more often
acceptance criteria¶
- AC1: the API documentation provides grouping based on use cases
- AC2: documentation provides something human readable
- AC3: documentation is automatically updated from source code
tasks¶
- Evaluate https://metacpan.org/pod/Mojolicious::Plugin::OpenAPI, https://metacpan.org/pod/Mojolicious::Plugin::OpenAPI::Modern
- if feasible rewrite current WebAPI.pm to use that
further details¶
Currently we have all available API routes listed on routes, e.g. https://openqa.opensuse.org/all_the_routes but some are missing some human description and are also not grouped in a sensible way by use, only by definition.
Other interesting references:
Actions