UPD: I wrote this for swagger v1.2. Stuff has changed since then. Now swagger supports single-file YAML specifications, so making them is easier now. What a time to be alive!
A few days ago was the first time I created a REST API documentation. This is the report on how I did it.