I completely understand (and have had) the problem, but I don't understand the solution that this offers?

Or rather, I didn't without going Readme > Wiki > User Guide > something else - a YAML example should really be in the readme, this looks great!