godoc improvement: some comments are shown as comments

[mdomlad85]

When I go to type with a link (i.e. https://golang.org/src/builtin/builtin.go#L255) I got field list with comments instead of nicely formatted as it is on functions and structs. This should be done on any fields (constants too). Generally, the comment should never be presented as a comment but nicely formatted and connected to the part where it is commented.

[urandom2]

I am a little unclear what issue you are describing. Can you rephrase, and if possible provide screenshots of behaviour?

That being said, it sounds like you could be complaining about the way struct fields are displayed:

And you would like the fields broken out as hierarchical sub-elements, similar to funcs (even top level ones):

Assuming that is the case, this feels like a proposal and is above my pay grade, however I would suggest you build a mock-up to better sell your position.