{"API Evangelist"}

Dwolla Using Slate For An Evolved API Documentation Experience

I'm liking the new Dwolla's new API docs that they just launched. They are using an open source API documentation framework called Slate, developed by Tripit, for their own API documentation. 

I enjoy seeing the different directions that providers take with their API docs. Slate's approach is a different path than we've been seeing with interactive docs using frameworks like Swagger, but provides a very intuitive, elegant documentation experience which includes code samples tailored to each API endpoint.

Here are the features Slate lists on the Github repository for the project:

Slate provides some pretty interesting tools for any API documentation toolbox. I also really like that they are Github-centric, acknowledging that many API providers will use Github Pages when deploying their docs, adding that "Not only does this mean you get free hosting for your docs with Github Pages, but it also makes it's simple for other developers to make pull requests to your docs if they find typos or other problems.” - something I thoroughly enjoy across the API Evangelist network.

It looks like to me (maybe I’m wrong) that the code samples are hand written? Something that could easily be remedied using Swagger. It would be way cool to see a Swagger and API Blueprint generated version of Slate emerge—merging the Slate experience, with the interactive documentation experience we’ve seen evolve over the last couple years. This way your docs would be elegant, interactive, and very utilitarian with the inline code samples. 

Nice job Dwolla!