Fix formatting in the README, and make clear that generated Doxygen files need to be manually comitted.
Fix links on API landing page.