As a data format, yaml is extremely complicated and it has many footguns. In this post I explain some of those pitfalls by means of an example, and I suggest a few simpler and safer yaml alternatives.
A 10 minute read covering some YAML edge-cases that you should have in mind when writing complex YAML files
Writing YAML is only better than writing XML. I’d rather read and write JSON, which is allegedly not “human-friendly” for some reason.
If you get to choose a format, please pick something else. There are plenty of better options these days.