Much of the WP REST API v2 documentation is automatically generated from demo.wp-api.org/wp-json/?context=help. A Ruby script dumps the JSON into _data, and Jekyll generates pages like this:
It would be cool if someone wrote a WordPress theme (or plugin) to automatically generate a documentation site from a WP REST API index — and the only configuration parameter was the URL to the endpoint.