Merge pull request #593 from alex/better-readme

Fixed #576 -- improve the readme