README.md updated
Improved comments for godoc