Quality of life

[christopherjbaker]

I apologize. I was cleaning up my repo and deleted the branch, which closed the PR. here is the same PR as #64

Been trying to dig into Feathers recently, and like it very much so far! Found feathers-swagger, which made things even better. XD Found a bit of missing functionality, though.

As far as I can tell, this should fully backwards compatible.

1. The id names are fixed to resourceId (at least in the parameters, though the url is set properly). The type is also fixed at integer. The parameter name is now set the same way the URL was before, and the type still defaults to integer, but can be overwritten at docs.idType.

2. Only the getWithId endpoint had any responses defined, and only the 200, and with no schema. All endpoints have the appropriate responses (as far as I can tell), and off the appropriate schema (with a new list schema defined for the getWithoutId endpoint). Schema refs are also now build with the tag instead of model, the same place they were previously added if a doc.definition was present.

3. List parameters have been added for $limit, $skip, and $sort.

[daffl]

Those are great, thank you! Released as v0.5.0