Please follow the http://blog.golang.org/godoc-documenting-go-code style guide among others.