Mitchell McKenna - tagged with documentation http://mitchmckenna.com/feed en-us http://blogs.law.harvard.edu/tech/rss LifePress mitchellmckenna@gmail.com Dredd - API Testing Framework http://mitchmckenna.com/post/15790/dredd-api-testing-framework

Dredd is a command-line tool for validating API documentation written in API Blueprint format against its actual code. With Dredd you can easily plug your API documentation into a Continous Integration system like Travis CI or Jenkins and have API documentation up-to-date, all the time. Works to test API's written in PHP, Node.js, Ruby and Python. I've been using Swagger for API docs, but I'm looking forward to trying out Dredd + Blueprint in a future project.

]]>
Sat, 26 Sep 2015 20:59:00 -0400 http://mitchmckenna.com/post/15790/dredd-api-testing-framework/dredd-api-testing-framework
I/O Docs - API Documentation Generator http://mitchmckenna.com/post/13302/io-docs-api-documentation-generator

I/O Docs is a live interactive documentation system for RESTful web APIs. Open sourced by the talented API guys at Mashery. I/O Docs is a lot like Swagger except I/O Docs isn't just a spec, it's the interpreter as well and it's written in NodeJS.

]]>
Sat, 24 Aug 2013 15:14:00 -0400 http://mitchmckenna.com/post/13302/io-docs-api-documentation-generator/io-docs-api-documentation-generator
Swagger: REST API Documentation Generator http://mitchmckenna.com/post/13301/swagger-rest-api-documentation-generator

Swagger is a popular open source spec to auto-generate very nice looking API documentation with the ability to easily try any API request. You can use the Swagger's own swagger-core framework for node.js, Java or scala, but there's is also support in many other languages because of the strong open source community behind it for other languages like PHP, Ruby, Python, etc. Swagger's biggest open source competitor is Mashery's I/O Docs.

]]>
Sat, 24 Aug 2013 15:04:00 -0400 http://mitchmckenna.com/post/13301/swagger-rest-api-documentation-generator/swagger-rest-api-documentation-generator