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

Golang x/website: tables are awkwardly formatted

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.

Comment From: hyangah

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

Comment From: gopherbot

Change https://go.dev/cl/592955 mentions this issue: _content: add styles for mod table

Comment From: kevinpeno

Not sure where to throw it, but the following worked well for that page, imo. The padding isn't necessary, but I thought it helped readability a little bit. I didn't see .ModTable defined anywhere in styles.css, so there shouldn't be any conflicts.

.ModTable th, .ModTable td {
    vertical-align: baseline;
    text-align: left;
    padding: 1rem;
}

Screenshot 2024-10-13 200255 Screenshot 2024-10-13 200238 Screenshot 2024-10-13 200218

Comment From: deitrix

Bringing over my two cents from the duplicate issue. Alternating the row's background colour is another way to go. Maybe even a combination of the two for maximum accessibility!

Image

Comment From: gopherbot

Change https://go.dev/cl/691616 mentions this issue: _content/css: style tables produced from markdown