Go: x/pkgsite: The new index is hard to read

Created on 9 Sep 2020  路  3Comments  路  Source: golang/go

What is the URL of the page with the issue?

https://pkg.go.dev/net/http?tab=doc

What is your user agent?

Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/85.0.4183.83 Safari/537.36

Screenshot

image

What did you do?

I was looking for the name of a function that does what I want to do.

What did you expect to see?

Expected to quickly find the function I want.

What did you see instead?

Because the index is in a narrow strip on the left, and because functions' returns are no longer in the index; it's very hard to see an overview of the package, because:

  • You can't see the returns of a function in the index. Often seeing a compact list of functions in the package or methods in a type with their arguments and returns is all you need to lead you in the direction of the function that does what you want.
  • In the main view there is little visual cue where one type's methods stop and another type begins. In the index this is very clear due to the indent. Scanning the main page to see functions' returns is visual overload to me, I just want to do it in the index.

In summary, please put the index back near the top like it is on godoc.org.

pkgsite

Most helpful comment

This is the index I'm talking about. Usually just looking at this format of index is almost all I need to use a godoc. It's just a matter of seeing a function that takes what you have and returns what you want then clicking on it to check its docstring:
image

All 3 comments

This is the index I'm talking about. Usually just looking at this format of index is almost all I need to use a godoc. It's just a matter of seeing a function that takes what you have and returns what you want then clicking on it to check its docstring:
image

Related to (if not a dup of) https://github.com/golang/go/issues/40612.

Related to (if not a dup of) #40612.

I think my concern is entirely a subset of that issue, thanks.

Was this page helpful?
0 / 5 - 0 ratings