Skip to content

Change vertical alignment of table cells

Amy Qualls requested to merge docs-aqualls-table-alignment into master

I have a personal bias against how the tables in the body section of our documentation are presented. I think the <td> cells should be vertically aligned toward the top of the cell, because I think a straight horizontal line of text is easier to read than jumping up and down.

An example of a table with significant height difference in cells: https://docs.gitlab.com/ee/api/graphql/reference/index.html#dastscannerprofile

In the spirit of bias-for-action, I'm proposing an initial (and probably incorrect) MR that attempts to modify the styling of <tbody>. It's probably both the wrong property and the wrong place, but I want to spark some discussion here.

Am I the only one bothered by the table appearance? Or has it bothered everyone and we've just not acted on it?

Before After
Reading across requires the eye to jump up and down Reading is smoother
before after

Related to gitlab#300424 (closed)

Edited by Achilleas Pipinellis

Merge request reports