Documenting a Go package with Hugo

from https://github.com/spf13/hugo/issues/517

Is there a theme, guide, etc for integrating Go documentation with a Hugo project?

So, I do something like that here: npf.io/lumberjack.v2

I first use godoc2md to convert the godoc for the package into markdown, then I manaully massage the markdown… with a template and some metadata specific to my site.

The massage is necessary because godoc2md isn’t perfect. One big hole is that it leaves out the example functions, which I use fairly extensively… so I often will go copy and paste those from godoc.org for my package and manually insert them into the markdown.

I added support for badges, since I like showing that my stuff is getting tested etc, and that falls outside of the godoc, but I feel it’s important.