Here's a blog post explaining how it works: <a href="http://smsohan.com/blog/2015/01/13/you-can-haz-automated-rest-api-documentation/" rel="nofollow">http://smsohan.com/blog/2015/01/13/you-can-haz-automated-res...</a>