Improved documentation / README

Changed parameter documentation to example based explanation. Fixed some formatting and code style
Merge pull request #369 from Zauberfisch/patch-1

Improved documentation / README