I spent some time trying to automatically generate HTML documentation from YAML with inline comments. I got as far as generating a nice set of nested tables.

Feel free to use it :)

Here is the gist