/ go Public
x/pkgsite: display struct field & interface method doc comments in a less code-ish way? #39963
Someone must examine and confirm this is a valid issue and not a duplicate of an existing one.
Issues that involve UXD/UXR input
Apologies if this is something that's been suggested a million times, but... while I like the pkg.go.dev docs UI better than godoc.org, it keeps the same way of presenting struct and interface documentation, which I find awkward. The definitions are displayed literally as Go code, with all the doc comments looking like just that: code comments. To me, there are several problems with this:
I can't think of any conceptual reason why the doc comments for struct fields and interface methods should be treated so differently from types and implementation methods. If someone really wants to see what these definitions look like in their original Go code format, there's already a link to the source code right there.
What is the URL of the page with the issue?
Any page with a struct or an interface on it, for instance this or this.
What is your user agent?
Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.106 Safari/537.36
What did you do?
Viewed the documentation for some structs and interfaces.
What did you expect to see?
No particular expectations, but it would've been nice to see something other than the way godoc.org does it.
What did you see instead?
A block of Go code, the same way godoc.org does it.
The text was updated successfully, but these errors were encountered: