Problem: Readme is written in pure markdown
Solution: Use gitdown to generate markdown readme.
Problem: Typos, wrong information and huge toc
Solution: fix typos, add correct information and shrink toc
Problem: Wrong grammar
Solution: fix grammar
Merge pull request #51 from sappo/master

Problem: Readme is inconsitent with explanations in project.xml