Improved documentation / README

Changed parameter documentation to example based explanation. Fixed some formatting and code style