Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

Apiary is great! I used them for documenting the Tesla Model S API: http://docs.timdorr.apiary.io/

All I had to do was create a github repo and that was it: https://github.com/timdorr/model-s-api

It's great for public projects because there are both comments, which allows for inline discussion, and a mock API server, which doesn't help me so much (Tesla's API implementation isn't true REST) but allows others to throw things at an endpoint without worrying about consequences.

One of the devs was even willing to get involved and issued a pull request for the repo! https://github.com/timdorr/model-s-api/commit/b0669d Awesome guys!



Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: