docs/README.md: to render nicer pages on github

... as previously the README.cmake would be picked and put at the bottom
of the docs page there and it wasn't very representative!