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
This is kinda my experience. If there’s an extension keeping track of schema and linting, it’s alright.
If you’re doing it by hand, well, good luck.
My personal favourite way to make configs is lua. But that’s neither here nor there.