more docs for yaml files
(#343)