Update README.md

Changed the readme structure a bit, also fixed syntax error for the import statement showed.
Update README.md

Add godoc link
Fixed formatting of method comments for godoc + added comments for JSON factory methods
Integrated Henrik's docu fixes / Added array accessors / Added accessors to sub structures / Extended demos