[Koha-bugs] [Bug 28463] New: Change spec for better looking in the docs

[bugzilla-daemon at bugs.koha-community.org]

https://bugs.koha-community.org/bugzilla3/show_bug.cgi?id=28463

            Bug ID: 28463
           Summary: Change spec for better looking in the docs
 Change sponsored?: ---
           Product: Koha
           Version: master
          Hardware: All
                OS: All
            Status: NEW
          Severity: enhancement
          Priority: P5 - low
         Component: REST API
          Assignee: koha-bugs at lists.koha-community.org
          Reporter: tomascohen at gmail.com

Now that we are making our API spec public [1] we need to take care of little
details we didn't consider.

Some of them:
- Our tags are all lower-case and single-worded, like illrequests
- They lack descriptions (addSMTPServer could have some nicely written
description like 'Add SMTP server').
- Our tags are 'tag cloud' oriented, as with SwaggerUI showing them with
colors, but ReDoc uses them to organize the navigator, so they need to be
cleaned. We cannot have 'patrons' and 'patron', it should just be one.

-- 
You are receiving this mail because:
You are watching all bug changes.
You are the assignee for the bug.