My experience failing with YAML: I've converted a visual workflow tool into a YAML file mode so I could give my users a file format they could edit, share and v

My experience failing with YAML: I've converted a visual workflow tool into a YAML file mode so I could give my users a file format they could edit, share and version with any text editor and commit to a git repo. The result was that they were at a loss trying to figure out the free-form map and array structures. They could not grasp when to use dashes (arrays) mixed with maps (array of maps) and would fail to indent structures all the time. Trying to create meaningful error reporting was very hard since their mistakes were also valid YAML. YAML is definitely powerful but can become too complex too fast. And being a format full of sigils and its TIMTOWTDI "there's more than a way to do it" approach can easily enrage lean purists and complexity detractors, hence the hatred.