Talk:Requests for comment/Content API

Swagger has some useful code generation tools (e.g. swagger-codegen and swagger-js-codegen) that make it much easier to follow design by contract (in which the API is specified indepenently of the code that implements it). This helps all sorts of things, including test automation (e.g. ensuring that implementations correctly follow the specification), modularization (e.g. allowing disparate teams to trust the specification rather than interdependencies on implementations), and documentation (e.g. via tools like swagger-ui). James Earl Douglas (talk) 03:45, 13 October 2014 (UTC)


 * James, thanks for plugging Swagger. We decided to go with Swagger 2 for many of these reasons. The implementation is tracked in this bug. -- Gabriel Wicke (GWicke) (talk) 01:55, 14 October 2014 (UTC)