Fixing a broken link I found on documentation site and updated the README

I might have got carried away with the changes to the README. Hope this helps.