GoDoc generates documentation from Go source code. The guidelines for writing documentation for the godoc tool apply to GoDoc.
It's important to write a good summary of the package in the first sentence of the package comment. GoDoc indexes the first sentence and displays the first sentence in package lists.