News for hackers. Stuff that matters.
Re:Ask HN: Idea Sunday by callmeed on Sunday April 06, 2014 @07:57PM (#7543820)
API documentation tool: If you have a REST(ish) API, the tool would allow you to:

* Describe the authentication

* Enter all the objects, methods, URL endpoints, and parameters of your API

The tool would then:

* Generate pretty documentation, including example requests/responses

* Include a working web-based API console (like Mashery has)

* Auto-generates client libraries in Ruby, Python, PHP, Node, Obj-C, etc. and keep them updated in GitHub

Bonus points for bootstrapping the API information from your Rails routes file.

Re:Ask HN: Idea Sunday by intelekshual on Sunday April 06, 2014 @08:39PM (#7543974)
RAML promises most of this: http://raml.org/ Specifically, check out the projects section, which includes: an API designer, an API console and a documentation generator.
Re:Ask HN: Idea Sunday by sunir on Sunday April 06, 2014 @09:31PM (#7544161)
Re:Ask HN: Idea Sunday by dabernathy89 on Sunday April 06, 2014 @10:54PM (#7544380)
Holy crap, that looks fantastic.
Re:Ask HN: Idea Sunday by dcposch on Monday April 07, 2014 @03:36PM (#7548823)
I like Apiary a lot so far