Godoc is a very powerful tool, but very few projects utilize its full potential.
It is often not used at all as a developer tool. Sometimes it is used, but only for short comments to describe what is already obvious. Much less often it is used to fully describe documentation for the code.
I will tell you how to use the full potential of godoc and write informative and related documentation with its help.