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: #49838

Closed
potano opened this issue Nov 29, 2021 · 2 comments
Closed

x/pkgsite: #49838

potano opened this issue Nov 29, 2021 · 2 comments

Comments

@potano
Copy link

potano commented Nov 29, 2021

What is the URL of the page with the issue? https://pkg.go.dev/

What is your user agent? Chromium (Gentoo Linux)

Screenshot

image

What did you do? Entered golang.org in browser's URL bar, noted redirect to go.dev, clicked on the Packages link at the top of the page, looked in vain for the list of standard Go packages

What did you expect to see? A listing of standard-library packages:

image

What did you see instead? A search page for any package (standard or user-submitted) on pkg.go.dev

I have often made use of the Packages link on golang.org to search for standard packages and the Documentation link to see standard documentation. Fortunately the redesign has not screwed up the latter, but does give me a problem when I want to look for standard packages.

Investigation using the Wayback Machine gives me insight into the issue: before November 23 the Packages link on golang.org gave a redirect to pkg.go.dev/std whereas today the link on the redirected page goes to pkg.go.dev. So now my problem comes down to the design of your site navigation and--more fundamentally--to the design philosophies of the two sites, golang.org and go.dev.

I know that you have expended great effort into the search functionality of pkg.go.dev and have commented about this on the blog. I never tried using it since I try hard to use only the standard library. Now that you've instituted the redirect to go.dev the search function is all I get. You really need to make a link to pkg.go.dev/std. It could go onto the search page that currently displays at pkg.go.dev.

Others have commented on the substitution of go.dev for golang.org. I really appreciated the design of the golang.org page for its spareness and high information-to-space ratio. There is way too much going on the go.dev page for anyone not first investigating the Go language and ecosystem. Even the navigation links speak to this. On golang.org the choices were Documents / Packages / The Project / Help / Blog / Play. The new page drops The Project and Help in favor of Why Go and Get Started. Let me give you a hint: someone who already uses Go no longer needs Why Go or Get Started but does need links to things like forums, wiki, and mailing lists. Where are links to those on the new site? I have to use the Wayback Machine to find them.

If you do find it necessary to offer a site to entice new users to Go, please consider maintaining a separate site for current users looking for authoritative answers.

@gopherbot gopherbot added this to the pkgsite/unplanned milestone Nov 29, 2021
@ALTree
Copy link
Member

ALTree commented Nov 29, 2021

Regarding discoverability of the standard library documentation, see #49737, #40785. #49768 is also relevant. I think there's some work in progress to link the std page in https://pkg.go.dev/.

In general I doubt they'll ever go back to a two-website setup... golang.org was effectively dismissed.

@seankhliao
Copy link
Member

Closing as dup as I think the main points are covered by the linked issues

@golang golang locked and limited conversation to collaborators Nov 29, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
Development

No branches or pull requests

4 participants