Improved documentation / README

Changed parameter documentation to example based explanation. Fixed some formatting and code style

let's speak code! I am pretty sure that describing the parameters in a context makes it a lot easier to understand. also this way it comes with nice colors <3