I wish variables were listed as well, just like types and functions, with types' methods and functions expanded as well.

There's another annoying CSS thing. Currently the navigation has overflow-y: scroll which shows an ugly scroll bar even when it's not needed.

Picture

I suggest it gets removed. The default behavior will be the scrollbar appearance once the content exceeds the element height (which could be set to something like 80vh or calc(100vh - var(--navbar-height))).

I also suggest using something like simplebar or overlayScrollbars which provides a much nicer looking scrollbar (for the navigation part) without sacrificing the default scrolling behavior.

Having the functions, types, and (possibly) variables in the sidebar expanded by default would make it easier to get a sense of the API at a glance. Still, it would be no substitute for the Index we know and love from godoc.org because full function signatures cannot fit comfortably into a sidebar.

Because the Index view contains so much high value content in a condensed form, there's often no need to drill any deeper. This is increasingly true over time as one becomes more familiar with a given API.

There's a related conversation happening in issue #40612 for including an Index-like view.

Another example where this causes problems: top-level functions that return a type declared in the package are grouped together with that type, which makes them hard to find when the index is collapsed.

Let's suppose I'm looking for a function in net/http that sends a GET request. I'd expand the Functions section on the left side bar to see if there's anything that sounds like it might help.

Unfortunately, the Get function is not listed there. Get has the signature func(string) (*Response, error), so it's grouped together with Response under Types. I would not have thought to look there.

This UI change is really making it hard to navigate the package docs. Package index is an entry point for many users. The index serves as a summary of what's in the package. Users often CTRL+F to search for symbols and go through the entire list to have an understanding of what package provides. Having to manually expand the list is breaking how we use the package index fundamentally.

On the search side, perhaps the sidebar could grow a search bar to make the "F" hotkey functionality more discoverable?

+1 for some kind of expand/collapse all button even with that.

@julieqiu @andybons Gentle ping. Would be good to know what you're thinking for this.

/cc @spf13 @fflewddur for product / UXR input

• Functions and types are now expanded by default as of https://golang.org/cl/248183. My guess is that we haven’t deployed that change yet and/or the documentation needs to be reprocessed.
• The fix to not show the scrollbar when there’s nothing to scroll has also landed.

There’s a lot of other feedback in this bug. May be worth splitting that out to separate issues. The original issue of not having the functions and types be expanded by default has been fixed (just not deployed).

Thanks @andybons. I agree that separate issues should be filed for other feedback. I'll open a new issue for grouping functions and types. EDIT: #40927

Change https://golang.org/cl/276234 mentions this issue: content/static: add sidebar expand and collapse on scroll

This issue should have been closed once the changes outlined in #40577 (comment) were deployed. Closing in favor of split-off bugs.