One of the worst things you can do with your software #documentation is supply only a single example of an acceptable YAML configuration.

Sure, the philosophical root issue is that YAML is so completely broken that it's impossible to extrapolate from any given example to any other even-slightly-different-in-any-way content and guess whether or not it's valid, which is the fault of YAML's creators. But you're entirely to blame for choosing to use it in your project.