initial attempt to make better readme
fixes from review
Merge pull request #129 from yast/better_readme

initial attempt to make better readme