added documentation to example yml and to README