On: Designing Great API Docs

[apievangelist]

In relationship to this post whats everyone thoughts on smart docs like Posterous has? aka Mashery I/O docs, Swagger?

It takes the API explorer model to the next level....and integrates with documentation.

You get up to date docs + API explorer + code stubs. Is this the future?