[doc] readme improvements
[doc] fix markdown in readme
Merge pull request #8 from mediascience/doc

documentation