Automated API documentation/testing

[Qwlouse]

We did talk several times about having an automatic API documentation generated from our code. I think this is tough to do, but I came across this set of tools to use a pretty readable markdown API-definition for automated testing of the API:

• http://sendgrid.com/blog/quickly-prototype-apis-apiary/
• http://apiary.io/
• https://github.com/apiaryio/dredd

I haven't fully read them, but it sounds interesting. Maybe at some point we can give them a closer look.