Update readme.md
Merge pull request #6 from kofalt/master

Documentation overhaul (common)