Linux Documentation
 help / color / mirror / Atom feed
From: Rito Rhymes <rito@ritovision.com>
To: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>,
	Hans Verkuil <hverkuil+cisco@kernel.org>
Cc: Jonathan Corbet <corbet@lwn.net>,
	Daniel Lundberg Pedersen <dlp@qtec.com>,
	Randy Dunlap <rdunlap@infradead.org>,
	linux-doc@vger.kernel.org, linux-media@vger.kernel.org
Subject: [PATCH 0/2] docs: make tables responsive with content-aware column widths
Date: Fri, 24 Jul 2026 17:42:46 -0400	[thread overview]
Message-ID: <20260724214249.23830-1-rito@ritovision.com> (raw)

This series establishes a responsive layout foundation for generated
tables throughout the documentation site. Wide tables can use contained
horizontal scrolling on narrow viewports instead of widening the page or
compressing their columns until the content becomes unreadable.

It also derives content-aware minimum widths for each column, giving
table content a reasonable floor before wrapping. This prevents
aggressive wrapping from collapsing a column's own text into nearly
vertical lines and prevents wider columns from squeezing neighboring
columns into the same unreadable state.

This addresses the current pathological failure modes in which tables
either widen the page beyond its margins or collapse columns into
nearly vertical text.

Integration note:

This series is intended to stack on top of Mauro's "docs: custom.css:
don't limit randering to old 800px monitors", retaining its 120em body
maximum.

Jon's revert of "docs: allow inline literals in paragraphs to wrap to
prevent overflow" should not be carried forward. Patch 2 retains
overflow-wrap: anywhere and prevents the unreadable table wrapping that
motivated the revert by adding content-derived column minimums.

Rito Rhymes (2):
  docs: apply contained horizontal scroll overflow to tables
  docs: derive table column minimum widths from content

 Documentation/conf.py                  |   1 +
 Documentation/sphinx-static/custom.css | 198 ++++++++++++++++++++++++-
 Documentation/sphinx/table_layout.py   | 136 +++++++++++++++++
 3 files changed, 334 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/sphinx/table_layout.py


base-commit: a635d6748234582ea287c5ffeae28b9b23f91c7e
-- 
2.51.0

             reply	other threads:[~2026-07-24 21:47 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-07-24 21:42 Rito Rhymes [this message]
2026-07-24 21:42 ` [PATCH 1/2] docs: apply contained horizontal scroll overflow to tables Rito Rhymes
2026-07-24 21:42 ` [PATCH 2/2] docs: derive table column minimum widths from content Rito Rhymes
2026-07-24 23:02 ` [PATCH 0/2] docs: make tables responsive with content-aware column widths Jonathan Corbet
2026-07-25  0:46   ` Rito Rhymes

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20260724214249.23830-1-rito@ritovision.com \
    --to=rito@ritovision.com \
    --cc=corbet@lwn.net \
    --cc=dlp@qtec.com \
    --cc=hverkuil+cisco@kernel.org \
    --cc=linux-doc@vger.kernel.org \
    --cc=linux-media@vger.kernel.org \
    --cc=mchehab+huawei@kernel.org \
    --cc=rdunlap@infradead.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox