added configuration documentation
optimized readme text
use single quotes in yaml for consistency

It should help users not familiar with YAML to avoid errors and read the code.
Merge pull request #79 from hagenburger/development

more documentation