From 47cd1bf5781df7cf4f2e425616965d325b1c4a83 Mon Sep 17 00:00:00 2001 From: ukimsanov Date: Wed, 29 Jul 2026 14:58:25 -0700 Subject: [PATCH] docs: widen the reading column by lifting the real constraint MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The previous attempt raised max-width on the article shell, which did nothing visible: the shell was never hitting that cap. Measuring the chain showed the left sidebar sits inside #body-content, whose max-w-8xl (1472px) was the binding limit — 1432 inner minus a 287px sidebar minus 128px of shell padding minus 352px of contents rail and gap lands on exactly the 664px column that was rendering. Raising #body-content, dropping the shell cap, trimming the left padding, and holding the contents rail to the 16rem it actually uses gives a measured column of 728px at 1440, 888px at 1600, and 1048px at 1920 — the last of which was previously stuck at 664 no matter how wide the display. No horizontal overflow at any of those widths. Setting a width on #content-area is pointless, as it is a flex item with grow that just fills the remainder; noted in the comment so the next person does not repeat it. --- docs/custom.css | 31 ++++++++++++++++++++++--------- 1 file changed, 22 insertions(+), 9 deletions(-) diff --git a/docs/custom.css b/docs/custom.css index 30e0a3c1bb..06f63174f5 100644 --- a/docs/custom.css +++ b/docs/custom.css @@ -138,22 +138,35 @@ h3 { * ID selectors deliberately: they outrank the theme's utility classes without * needing !important, so the cascade stays debuggable. */ @media (min-width: 1280px) { - #content-container { - max-width: 90rem; + /* The binding constraint. The left sidebar sits inside #body-content, so its + * max-w-8xl (1472px) cap was the real limit: 1432 inner − 287 sidebar = 1144, + * then −128 shell padding = 1016, then −352 for the contents rail and gap, + * which is exactly the 664px column we measured. */ + #body-content { + max-width: 110rem; } - #content-area { - width: calc(100% - 19rem); + /* Let the shell use what #body-content now offers, and reclaim some of the + * generous left padding. Setting a width on #content-area itself does + * nothing — it is a flex item with grow, so it simply fills what is left. */ + #content-container { + max-width: none; + padding-left: 2.5rem; + } + + /* The contents rail only ever renders ~256px of text. */ + #content-side-layout { + max-width: 16rem; } } /* Running prose stays inside a comfortable measure even though the column is - * now wide — long lines are measurably harder to read. Tables, media, cards, - * and code blocks are free to use the full width. */ + * now wide — long lines are measurably harder to read. Direct children of + * .prose only, so text inside cards, tables, and callouts is untouched. */ @media (min-width: 1280px) { - #content-area > div > p, - #content-area > div > ul, - #content-area > div > ol { + #content-area .prose > p, + #content-area .prose > ul, + #content-area .prose > ol { max-width: 80ch; } }