[doc] Add Readme and improve doxygen docs

This now uses Readme.md as main page and removes the separate
mainpage.md, adds a little bit more documentation, and hides
an internal doxygen file.