[doc] readme improvements
Merge pull request #4 from mediascience/doc

Documentation