x/pkgsite: verbosity dial #15005
Labels
NeedsDecision
Feedback is required from experts, contributors, and/or the community before a change can be made.
pkgsite
Tools
This label describes issues relating to any tools in the x/tools repository.
Milestone
Comments
|
This does seem like a cool idea. This might be a useful godoc.org thing. We could look at the most-used identifiers in a package and show them up front as a kind of "intro" view, then they could click below the fold to see the full story. |
|
I've had similar ideas for a while now. I completely agree something like this would be extremely helpful. When learning about a new package, the first thing I'm happy to see is a package summary that explains "how to get started". But of course it's only there if the package author is nice enough to provide it. Implementation wise, I have no concrete ideas how to actually do this. But I'm always thinking about it in the background. Just wanted to say 👍 to the idea and add my thoughts. |
|
For godoc.org, perhaps we can use statistics on the identifier use
frequency,
but for x/tools/cmd/godoc, I'm not sure if the standard packages are
representative
enough to extract generally useful statistics of usage.
|
ALTree
added
the
NeedsDecision
gopherbot
added
the
Tools
seankhliao
changed the title
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
I was joking to David that we should have a slider knob on godoc to choose how much crap in a package we show.
Imagine if a user loaded the net package and they only saw
DialandListenandConnby default, but then had to do something to show all the noise.I'm kinda joking, but kinda not. Maybe there's something to do here.
We've tried to address this in the past with package docs and examples, which helps, but also just adds to the overall noise.
Low priority.
/cc @adg
The text was updated successfully, but these errors were encountered: