Website: style release notes, docsy theme, table text overlap

[kbhawkey]

This is a Bug Report
Since adding the docsy theme, the tables in the v1.18 release notes display with errors.

Problem:
The table data overflows into the right hand column (TOC).

Proposed Solution:
Investigate wrapping the table text.

Page to Update:
https://kubernetes.io/docs/setup/release/notes/#downloads-for-v1-18-0

[sftim]

/kind bug
/priority important-soon

[sftim]

Could we specially style the <code> elements for checksums to allow them to break inside the word for wrapping?

[tengqm]

That means we need some tricks to identify checksums?

[kbhawkey]

https://github.com/kubernetes/release/blob/master/cmd/release-notes/README.md

[tengqm]

@kbhawkey Suppose you are hacking the generation of release notes ... you will be generating an "annotated" markdown so that a special class is associated with the checksum string? I'd suggest we try tackle this by tweaking the CSS, given that pages like https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/ are also suffering from this issue.

[sftim]

I _think_ I could make a (mainly) CSS change that doesn't require changes to release note generation, and is fairly robust.

[kbhawkey]

I am not proposing to modify the generation of the release notes. I simply added the link to the release notes tooling for some background information.
There are a number of problems with the tool reference pages:
The table data font size, table rows (stripes), missing right hand TOC, tables on the site are missing borders.

[celestehorgan]

@sftim Another option for display would be to have tables scroll horizontally once they hit their max-width, i.e. like this.

This would be a relatively simple fix and would serve us well for a number of scenarios.

[Arhell]

/assign @Arhell

[sftim]

/area web-development

[sftim]

@Arhell do you think any more work is needed here?

[Arhell]

@sftim no, tnxs.

[sftim]

/close

Done in #22167

[k8s-ci-robot]

@sftim: Closing this issue.

In response to this:

/close

Done in #22167

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes/test-infra repository.