Update basic docs closes #24

* added readme example
* added doc.go for godoc 
* updated some docs on objects