I know we don't have a documentation "doc" yet (https://github.com/Clever/dev-handbook/blob/master/documentation.md) but if we did I'd say for Go modules most of this should be in the godoc, e.g. `doc.go`. Example: https://github.com/Clever/gearadmin/blob/master/doc.go http://godoc.org/github.com/Clever/gearadmin)