Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

x/tools/cmd/godoc: verbosity dial #15005

Open
bradfitz opened this issue Mar 29, 2016 · 3 comments
Open

x/tools/cmd/godoc: verbosity dial #15005

bradfitz opened this issue Mar 29, 2016 · 3 comments
Labels
NeedsDecision Feedback is required from experts, contributors, and/or the community before a change can be made. Tools This label describes issues relating to any tools in the x/tools repository.
Milestone

Comments

@bradfitz
Copy link
Contributor

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 Dial and Listen and Conn by 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

@adg
Copy link
Contributor

adg commented Mar 29, 2016

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.

cc @alandonovan @shurcooL @shantuo

@dmitshur
Copy link
Contributor

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.

@minux
Copy link
Member

minux commented Mar 29, 2016 via email

@bradfitz bradfitz added this to the Unplanned milestone Apr 9, 2016
@ALTree ALTree added the NeedsDecision Feedback is required from experts, contributors, and/or the community before a change can be made. label Jul 18, 2017
@gopherbot gopherbot added the Tools This label describes issues relating to any tools in the x/tools repository. label Sep 12, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
NeedsDecision Feedback is required from experts, contributors, and/or the community before a change can be made. Tools This label describes issues relating to any tools in the x/tools repository.
Projects
None yet
Development

No branches or pull requests

6 participants