I didn't do a great job of this to start, but if we're adding a bunch of comments we should follow the Go commenting guidelines: 
http://golang.org/doc/articles/godoc_documenting_go_code.html

In particular:

> Notice this comment is a complete sentence that begins with the name of the element it describes.