Markdownified README and corrected typo

As part of http://24pullrequests.com/
Corrected links to folders

And also added tasks, as per https://help.github.com/articles/writing-on-github/ :)
merged David's doc improvements
Merge branch 'habi-master'