boostorg / website-v2-docs

Boost Site Documentation
https://docs.cppalliance.org
Boost Software License 1.0
6 stars 22 forks source link

Handle tables with many columns #358

Open alandefreitas opened 1 week ago

alandefreitas commented 1 week ago

Boost.URL has this table that's too large and ends up outside the area of the main content:

https://www.boost.org/doc/libs/master/doc/antora/url/reference.html

Image

There should be a solution where we can scroll right or some other option.

Of course, we can also rethink this individual Boost.URL table format. We migrated it from previous QuickBook documentation. But I expect this problem to reoccur with other libraries.

rbbeeston commented 1 week ago

Tables are generally a pain to deal with in this format. My preferred method would be to allow the table to scroll inside the div, and not allow it to go outside the div, but there are other who are strongly opposed to that.

The alternatives would be to find ways to shrink the table to force it to conform to the size or allow the container div to expand, even if it goes outside of pre-set boundaries.