Blog post and documentation of the YAML file syntax

[mirkoboehm]

I would like the actual documentation to be a "living document". It would be great if it could be created from a spec. Until then, let's write a blog post that explains the structure and attributes.