search

golang / go

The Go programming language
https://go.dev
BSD 3-Clause "New" or "Revised" License
120.66k stars 17.33k forks source link

x/website: tables are awkwardly formatted #67368

Open jjlin opened 1 month ago

jjlin commented 1 month ago

What is the URL of the page with the issue?

https://go.dev/ref/mod#environment-variables

What is your user agent?

Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36

Screenshot

image

What did you do?

Visit https://go.dev/ref/mod#environment-variables

What did you see happen?

The table of environment variables has no cell borders and the content is vertically centered. This makes it needlessly difficult to understand which variable corresponds to which description, and where one description ends and the next begins.

What did you expect to see?

If the table is going to have no borders, then I think the content should be top-aligned.

I'd expect that other tables in the Go documentation probably have this issue as well.

hyangah commented 3 weeks ago

I agree this table will look better and more readable if it's top-aligned. CSS adjustment for this table is welcome.