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/pkgsite: standard library packages are not discoverable #40785

Open
penmanglewood opened this issue Aug 14, 2020 · 3 comments
Open

x/pkgsite: standard library packages are not discoverable #40785

penmanglewood opened this issue Aug 14, 2020 · 3 comments

Comments

@penmanglewood
Copy link

@penmanglewood penmanglewood commented Aug 14, 2020

What is the URL of the page with the issue?

https://pkg.go.dev/

What is your user agent?

Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_6) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/14.0 Safari/605.1.15

Screenshot

Screen Shot 2020-08-14 at 3 29 13 PM

What did you do?

I clicked on "Discover Packages".

What did you expect to see?

I expected to have the ability to discover packages, especially from the standard library, as the link promises.
On https://golang.org/pkg/, I am able to see at a glance the entire standard library and discover new packages I haven't used before.

What did you see instead?

Instead, I see a search bar. This indicates that I need to already know what I'm looking for.

@gopherbot gopherbot added this to the Unreleased milestone Aug 14, 2020
@dmitshur dmitshur changed the title x/pkgsite: Standard library packages are not discoverable x/pkgsite: standard library packages are not discoverable Aug 17, 2020
@dmitshur
Copy link
Member

@dmitshur dmitshur commented Aug 17, 2020

On https://golang.org/pkg/, only the packages from the standard library are included, so it is viable to list every single package in an exhaustive list on the front page. On https://pkg.go.dev, there are many more packages that can be discovered, so exhaustively listing them all on the front page is not viable.

Do you think something else can be done? Or is your suggestion to make it easier to understand how to find a list of packages that are only in the standard library?

One more question. Are you already aware of the https://pkg.go.dev/std page, which has a "Packages" tab that lists all packages? I'm asking because if you weren't aware of it, it's possible that making that page more discoverable can be a way to improve the situation.

/cc @julieqiu @jba @jamalc per owners.

@penmanglewood
Copy link
Author

@penmanglewood penmanglewood commented Aug 27, 2020

Do you think something else can be done? Or is your suggestion to make it easier to understand how to find a list of packages that are only in the standard library?

Yes I was suggesting making it easier to discover standard library packages without needing to know about their existence in the first place.

https://godoc.org lists the top 25 packages by popularity and has links to the standard library, golang.org/x packages, and various search filters on Github. This level of discoverability is nice, in my humble opinion.

Given that a flash message on https://godoc.org is currently offering to "Always use pkg.go.dev" instead of godoc.org, it would be great to keep this level of discoverability in the new offering.

@penmanglewood
Copy link
Author

@penmanglewood penmanglewood commented Aug 28, 2020

One more question. Are you already aware of the https://pkg.go.dev/std page, which has a "Packages" tab that lists all packages? I'm asking because if you weren't aware of it, it's possible that making that page more discoverable can be a way to improve the situation.

I wasn't aware of this page. Thank you for pointing it out.

For the purposes of making this issue actionable, I second your suggestion of linking to https://pkg.go.dev/std from the "Discover Packages" page.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
4 participants
You can’t perform that action at this time.