Update readme 

Removed inline examples, replaced with links to official documentation. 
Also updated installation section, and unified headings throughout.