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/website: 'Packages' link mistakenly points to search box instead of standard package docs #49737

Closed
eikenb opened this issue Nov 23, 2021 · 7 comments

Comments

@eikenb
Copy link

eikenb commented Nov 23, 2021

New go.dev website's Packages link should go to the standard package docs (https://pkg.go.dev/std), not a search box. That is the new site has a regression in usability and should be reverted to the direct link.

@gopherbot gopherbot added this to the Unreleased milestone Nov 23, 2021
@rsc
Copy link
Contributor

rsc commented Nov 23, 2021

golang.org and go.dev were inconsistent in what the top bar 'Packages' link pointed to.
On golang.org it pointed to the standard library (like https://go.dev/pkg/?m=old).
On go.dev it pointed to pkg.go.dev.

We have to pick just one, and it seems far more useful to me
to go to a page that lets you find any package,
instead of a page that only shows some packages.

I believe the current behavior, of linking to pkg.go.dev, is working as intended.

@rsc
Copy link
Contributor

rsc commented Nov 23, 2021

/cc @jamalc @julieqiu @dmitshur in case I am wrong about this.

@ALTree
Copy link
Member

ALTree commented Nov 23, 2021

It makes sense for the Packages item on https://go.dev/ to go to the general pkgs search, but how do you discover https://pkg.go.dev/std now? Searching for "std" on https://pkg.go.dev/ doesn't work.

There has to be a way to find out what packages Go actually ships with. The quickest way appears to be: click on Docs to reach https://go.dev/doc/, then scroll down to

Package Documentation

The documentation for the Go standard library.

which then links to https://pkg.go.dev/std, under the cryptic "Package Documentation" title (what package?) But that's like two thirds down, in a page with other 45 links, all equally prominent.

IMO there should be a link to https://pkg.go.dev/std prominent on https://pkg.go.dev/. So I would see something like "Standard library documentation" that jumps to https://pkg.go.dev/std, or I'd use the search bar if instead I wanted to look for 3rd party packages.

@ALTree ALTree added the pkgsite label Nov 23, 2021
@seankhliao
Copy link
Member

I believe that part is #40785

@ALTree
Copy link
Member

ALTree commented Nov 23, 2021

Ah, that's right. I forgot about that one. It certainly got more relevant now that the migration to go.dev is in progress.

@gopherbot
Copy link

Change https://golang.org/cl/366577 mentions this issue: _content: adjust footer

@rsc
Copy link
Contributor

rsc commented Nov 24, 2021

I sent a CL to put "Standard Library" in the footer menu under "Packages".

@rsc rsc self-assigned this Nov 24, 2021
@ALTree ALTree mentioned this issue Nov 29, 2021
@rsc rsc removed their assignment Jun 23, 2022
passionSeven added a commit to passionSeven/website that referenced this issue Oct 18, 2022
Change footer About heading to link to /project.
Linking to /about was always mainly about pkg.go.dev,
and now it redirects to pkg.go.dev/about, so that's clearly wrong.
But we need a link to somewhere, and we also need a link to /project
(which used to a be a top-level heading on golang.org),
so it's a good match.

Add Standard Library to Packages section.

Add Help to Get Started section.
(Used to be a top-level heading on golang.org.)

For golang/go#40785 (but probably more to do there).
Fixes golang/go#49737.
Fixes golang/go#49768.

Change-Id: I4a0837aaaa89b3bd79bda7a55bcff3a5ef9e206b
Reviewed-on: https://go-review.googlesource.com/c/website/+/366577
Trust: Russ Cox <rsc@golang.org>
Run-TryBot: Russ Cox <rsc@golang.org>
TryBot-Result: Go Bot <gobot@golang.org>
Reviewed-by: Jamal Carvalho <jamal@golang.org>
@golang golang locked and limited conversation to collaborators Jun 23, 2023
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

5 participants