Clean-up README.md

[rezib]

Now that we have a nice and almost complete documentation, the README.md can be mostly cleaned-up and refer to the real documentation where appropriate.