Skip to content

docs: use wide mode on pages with 5-column tables - #782

Merged
hlenke merged 1 commit into
mainfrom
hannes/wide-mode-wide-tables
Nov 2, 2026
Merged

hlenke merged 1 commit into
mainfrom
hannes/wide-mode-wide-tables

Conversation

@hlenke

@hlenke hlenke commented Nov 2, 2026 •

Copy link
Copy Markdown
Member

Affected Components

  • Content & Marketing
  • Pricing
  • Test
  • Docs
  • Learn
  • Other

Notes for the Reviewer

Every docs table with 5 or more columns is cut off on desktop. Mintlify gives each table cell a minimum width of 150px ([&_td]:min-w-[150px]), so a 5-column table is at least 750px wide. With the "On this page" panel shown, the content column is only 630–700px (about 40px less inside Tabs). The table scrolls, but the scrollbar is hidden, so the Description column just looks cut off.

This PR adds mode: "wide" to the 26 affected pages: 23 construct pages plus admin/team-management/overview, communicate/alerts/overview and platform/data-storage. Wide mode hides the "On this page" panel and widens the content column. On the construct pages that panel only lists a few sections (Configuration, option groups, Examples).

Measured on the live site and on this PR's preview. A headless browser clicked every tab and compared each table with its container:

Viewport Tables cut off before After
1920px 55 0
1440px 55 0
1280px (changed pages) 74 1

Please look at:

  • admin/team-management/overview: the 6-column permissions table is still 36px too wide at 1280px. It also loses the longest "On this page" panel of the 26 (15 headings). Splitting that table may be the better fix, and I can take wide mode off that page if you prefer.
  • Out of scope here: 17 four-column tables on 14 other pages are cut off at 1280px only. They fit at 1440px and wider.
  • Not done: overriding the 150px rule in style.css. I tested it, and code in the Type and Default columns broke mid-word more often. The CSS would also depend on Mintlify's internal class names.

Screenshots

There are before/after screenshots for all 26 pages (1440×900, scrolled to each page's worst table), plus per-page numbers, in the report: https://claude.ai/artifact/3xvix7vJDbg3wnjY9wzAjs

Preview: https://checkly-422f444a-hannes-wide-mode-wide-tables.mintlify.site/constructs/dns-monitor

🤖 Generated with Claude Code

Mintlify gives every table cell a 150px minimum width, so a 5-column
table is at least 750px wide. With the "On this page" panel shown, the
content column is 630-700px, so all 55 tables with 5+ columns overflowed
at every desktop width and their Description column was cut off behind
a hidden scrollbar. Wide mode hides that panel and gives the content
column the room these tables need.

Affects 26 pages: 23 construct pages plus admin/team-management/overview,
communicate/alerts/overview and platform/data-storage.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Nov 2, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
checkly-422f444a 🟢 Ready View Preview Nov 2, 2026, 10:13 PM

@hlenke
hlenke marked this pull request as ready for review November 2, 2026 22:18
@hlenke
hlenke merged commit 16e9c87 into main Nov 2, 2026
9 checks passed
@hlenke
hlenke deleted the hannes/wide-mode-wide-tables branch November 2, 2026 22:44

This branch was successfully deployed

1 active deployment
staging — ab59e048 Deployed Nov 2, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant