Re-posting an article by Ruud van Asseldonk discussing the pitfalls of YAML. For what it is worth, I am firmly on team
extend JSON with comments and commas; but that is for a different post.
The main take away I got from the article: always quote your strings. Which, really, is what JSON requires.