Today, I learned that Sphinx has a really awesome plugin for generating API docs for HTTP-based APIs called sphinxcontrib.httpdomain. It’s extremely simple to use and generates very nice looking documentation (which you’d expect from Sphinx.)