UPD: I wrote this for swagger v1.2. Stuff changed since then. Now swagger allows you using yaml and it wants just one file so making specs is easier now. What a time to be alive!
Few days ago was the first time I created a REST API documentation. This is the report how I did it.
Published at 2014-06-02