News for hackers. Stuff that matters.
Re:Swagger: A simple, open standard for describing REST APIs... by jcromartie on Monday March 26, 2012 @10:24PM (#3759673)
Yes, that's the key. If the media types are documented (like how browsers and developers understand HTML forms) then you don't need to document every single corner of the API. You can offer a good definition of the media types, and let the resources and links do the rest.

There are no comments on this comment yet.