fix and update Readme

 * GitHub has new URLs for raw repo content, so I had to update doc URL.
 * Few typos are fixed.
 * Issue #3 is now linked in MacVim section.