Readme update WIP

Attempt to resolve #345. added formatting, code examples, syntax highlighting.



Need a partner to help me finish this up. some functions don't have examples and some descriptions may need to be updated and clarified further.