Use a schema to validate yaml input

[lucc]

Currently we do validate the yaml data by hand, see the update() method. This is cumbersome and not documented. We should use a schema (and probably a library) instead and communicate the expected yaml schema in the docs properly.