Update readme.md

Clearer language, links to referenced source code.