Finish README, fixes #1

Added @mpturn's comments to the README file.