Document/enforce schema for configuration YAML files

[thvasilo]

We should document the expected schema for the configuration YAML and verify it during parsing, to provide better errors if the user has wrong indentation in their config.