We should try to follow the standard Go comment guidelines:
http://golang.org/doc/articles/godoc_documenting_go_code.html

e.g.

// Transport initializes the stmp client.