Use `doc.go` for documentation

[RicYaben]

We should use the format doc.go to add descriptions to packages. This approach can be seen in bigger projects (e.g. Kubernetes) that start to see the complexities of the Golang project layout, and the Golang documentation official page Godoc