Support description

[gabrielacruz]

Handling parameters description would be a nice touch, maybe via YAML comments.
What do you think ?

[claytondaley]

Unfortunately pyYAML throws away comments at a very low level. There is a derivative of pyYAML that theoretically support it, but it would require either (1) changing the dependency for this package or (2) adding an YAML handler in a pluggable architecture.

In my company's fork (PR'd here), we've made some substantial architectural changes that might help you achieve this goal. For example, we're working towards a plugable framework.