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: add directories to "Jump to" list #44718

fzipp opened this issue Mar 1, 2021 · 4 comments

x/pkgsite: add directories to "Jump to" list #44718

fzipp opened this issue Mar 1, 2021 · 4 comments


Copy link

@fzipp fzipp commented Mar 1, 2021

For modules with many packages/directories like the standard library It would be helpful if directories were listed in the "Jump to" dialog.

Example use case

Press "f"
Type "template", and the "Jump to" dialog would list:

  • html/template
  • text/template
  • text/template/parse
Copy link

@jamalc jamalc commented Apr 12, 2021

The jump to button in the left sidebar shows up even if a page only has directories while the "f" key shortcut is disabled, this was brought up in #45462. We should put the button in a disabled state while we explore the idea of adding directories to the jump to modal.

Copy link

@gopherbot gopherbot commented Apr 12, 2021

Change mentions this issue: content/static: disable jump button for pages without docs

Copy link

@jamalc jamalc commented Apr 12, 2021

What should be the behavior of the 'Jump to' button and modal when the modal won't contain any identifiers

Screen Shot 2021-04-12 at 4 46 59 PM

Empty 'Jump to' modal

Screen Shot 2021-04-12 at 4 49 57 PM

The empty state appears directory pages (e.g. or and packages with little or no documentation (e.g.

Also, it might be more useful to explore the idea including headings from the README and directories. In that scenario the empty state would almost never come up.

Adding @georgehu and @fflewddur for UX input.

@jamalc jamalc added UX and removed help wanted labels Apr 12, 2021
Copy link

@fflewddur fflewddur commented Apr 12, 2021

Rather than disable the "Jump to" control when the modal would be empty, including an explanation in that modal that this package doesn't have any [list of things that are "jump to"-able] would help people understand why "jump to" isn't working on certain pages. I suspect if we just disable the control, we'll end up with bug reports that the control is disabled when people expect it to be available.

Long-term, I like the idea of using this control for quick keyboard navigation of the entire page, but agree that we'd want to explore this more first.

gopherbot pushed a commit to golang/pkgsite that referenced this issue Apr 14, 2021
The Jump to modal does not contain any jump-able items
on pages without documentation symbols. We plan to explore
adding identifiers from the readme and directories sections
in future updates to the modal.

For golang/go#44718

Change-Id: I71ea5caf2aee1960dec41f89f86ce861f944242a
Trust: Jamal Carvalho <>
Run-TryBot: Jamal Carvalho <>
Reviewed-by: Julie Qiu <>
Reviewed-by: Jonathan Amsterdam <>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

None yet
5 participants