Added a few more specific details about the YAML dependencies

When I was working on widgets, my main source of confusion was how to write YAML files. For example, I didn't even know that one could specify multiple script files with one per line starting with '-'  for example. So I added just a few more specifics about this that I think may help others.

fixed a few minor typos