README updated

this PR contains all changes from #1164