Inject schema details into the YAML doc as comments

[Daniel Bachhuber]

Editing a post looks like this:

YAML supports comments, so it would be cool if we injected comments from the schema about the resource into the document. For instance, any enum like status could indicate accepted values. And, of course, we can list the property description.

From #51