Problem: README is messy

* split auto generated documentation into GODOC.md.
* README will continue to evolve with simple overview examples.