Improve README.md

[phate]

The README.md could use an overhaul. What I think should happen:

1. Add list of content
2. Improve structure
3. Add links to doxygen documentation and wiki
4. Introduce sections for the different dialects