more yaml examples, readme

basic example of how the yaml is organized + readme