Complete support for REST API

[Glavin001]

Service's Operations:

• find
• get
• create
• update
• remove

Misc:

• Support handling docs attribute to the service object.
• Separate the services into separate Swagger API requests. Analogous to how http://swagger.wordnik.com/ works.

[Glavin001]

@daffl, what do you think of feathers-swagger so far for documentation? It's not yet completely usable, but what do you think of the concept itself.

[daffl]

Nice! I really like it. Looks like it already generates the basic documentation, so I think it could use something like Dox to parse the comments from a service file and set the Swagger options accordingly.

[Glavin001]

+1 for Dox support! Although, I want to make it documentation in the code as much as possible... maybe it could read the file with Dox and then pipe the Dox output back into the docs parameter of the service? I'll have to think more about this.

I was thinking of adding documentation generation to feathers-mongoose-service, because it already has the schemas. And I was going to access docs key in the service object as the way to customize Swagger API documentation for a service (description, and other such info).

[Glavin001]

@daffl, I just released version 0.2.0, which should pretty much support everything (for REST API) and allow complete freedom and usage of the Swagger API via the docs key of a service.

Let me know if you think this is release quality enough to be moved into the Feathers organization, if you'd like.

[daffl]

For a first version this is great. You're more than welcome to move it. I can look into the documentation parsing later.