Make real links in README.
Cleans annotations and comments. See #558