Go: x/pkgsite: make better use of horizontal space

[andybons]

With the new side navigation changes launched for documentation, we aren’t taking advantage of the amount of horizontal space we have (especially on wider viewports). This is to track investigating alternatives so that we can better use the space available.

https://stripe.com/docs/api does this rather well in my opinion.

[salewski]

It would be nice if something could be done to prevent the horizontal scrollbars and truncated content, as can be seen in the first screenshot below.

The page of the first screenshot is:

• https://pkg.go.dev/golang.org/x/oauth2?tab=doc

The page in the first screenshot is at 100% zoom, in chromium.

User-Agent: Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/83.0.4103.116 Safari/537.36

Despite there being tons of unused space on both sides of the page, the main content is still truncated. While I appreciate that overly wide columns of text are difficult to read, having the data truncated and needing to side-scroll -- especially multiple individual things to side-scroll -- is always worse.

For the sake of comparison, below is a screenshot of that content on godoc.org, on the page:

• https://godoc.org/golang.org/x/oauth2

There is less information displayed vertically, but none of it is truncated:

[mholt]

Just found this, but also made a related comment at https://github.com/golang/go/issues/40612#issuecomment-670275328

[gopherbot]

Change https://golang.org/cl/248857 mentions this issue: content/static,internal: allow fluid width for documentation

[julieqiu]

In case anyone missed it, mocks for the CL above are at https://github.com/golang/go/issues/40612#issuecomment-675735671

[tooolbox]

For the sake of comparison, below is a screenshot of that content on godoc.org, on the page:

There is less information displayed vertically, but none of it is truncated:

I believe that part of the truncation going on is due to the overall increased font sizes. /grump

😉

I am curious how https://github.com/golang/pkgsite/commit/47151e4cbeb8af373f39c3187044361a7510b404 will affect things, though.