Readme Update WIP

Attempt to resolve #345 . Added code examples, formatting, parameters explanations, code syntax highlighting and what not.

 need some feedback on format, someone to help me out to make sure everything is correct and concise. With two people working on this we can have this done quick and it'll be as correct as possible.