documentation: tables in HTML version do not break text and are hardly readable

[icedieler]

Describe the bug

The HTML documentation generated from the RST files does not break longer text in tables. Instead the browser renders a very wide table and displays a horizontal scroll bar at the bottom. For tables that are longer than the height of the browser window it is almost impossible to scroll the text to read it. This is very annoying. See the attached screenshot.

Steps to reproduce

1. Go to https://bob-build-tool.readthedocs.io/en/latest/manual/configuration.html#depends
2. Scroll down to the table where the details for each entry are described.
3. See the table row which describes the use property.

Context
Reproducible both with Firefox and Chrome browser on Linux

Possible fix

Would switching to RST list-table fix the problem?

[jkloetzke]

AFAICT this looks like this issue of the RTD-Theme. Either we apply the workaround in the CSS that someone proposed in the ticket or we have to replace the table and make subsections out of it. I'm not sure if the custom CSS properties have any drawbacks, though.

I guess switching to list-table won't make a difference.