Improve the README

Slight improvements to the README file so it links to the generated documentation and has proper build instructions.