Skip to content

docs(admin): fit the role matrix next to the On this page panel - #783

Merged
hlenke merged 2 commits into
mainfrom
hannes/team-roles-table
Nov 2, 2026
Merged

hlenke merged 2 commits into
mainfrom
hannes/team-roles-table

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

This keeps the role matrix on admin/team-management/overview exactly as it is. The table was clear; it was just too wide. Two changes make it fit:

  • Scoped CSS. The table is wrapped in <div className="role-matrix">. A rule in style.css drops Mintlify's 150px minimum cell width for that wrapper only (.role-matrix table td { min-width: 0 }). No other table on the site changes. Its selector is more specific than Mintlify's [&_td]:min-w-[150px], so it wins without !important.
  • No wide mode. mode: "wide" (from docs: use wide mode on pages with 5-column tables #782) is removed, so the page gets its "On this page" panel back. At 15 headings, it is the longest such panel of the pages docs: use wide mode on pages with 5-column tables #782 changed.

Measured on the preview:

Viewport Before After
1280px table 900px in an 864px column, cut off at Read Only table 472px in a 512px column, fits
1440px fits only in wide mode table 632px in a 672px column, fits, with the "On this page" panel

Things to decide:

  • Header wrapping. At 1280px the role headers wrap, and "Read & Write" takes three lines. All columns and check marks stay visible.
  • Coupling to Mintlify. The CSS only reverses Mintlify's own 150px rule. If Mintlify changes how tables are sized, the worst case is that this table overflows again.
  • The earlier 3-column version is dropped. This PR first merged the matrix and the "Choosing the Right Role" table into one table. That change is reverted, and the diff against main is now only the wrapper, the CSS rule and the removed wide mode. Squash on merge.

Screenshots

Before (live site, wide mode, no "On this page" panel):

1280px 1440px
Before at 1280px: the 6-column role matrix is cut off at the right edge Before at 1440px: the 6-column role matrix in wide mode

After (this PR's preview, same matrix, "On this page" panel back):

1280px 1440px
After at 1280px: the full 6-column role matrix fits next to the On this page panel After at 1440px: the full 6-column role matrix fits next to the On this page panel

Preview: https://checkly-422f444a-hannes-team-roles-table.mintlify.site/admin/team-management/overview

The screenshots live on the pr-assets/783 branch, which isn't meant to be merged. Delete it after this PR closes.

🤖 Generated with Claude Code

The built-in roles are strictly hierarchical, so the 6-column
capability matrix carried one fact per row: the lowest role that can do
it. Fold it into the "Choosing the right role" table as one row per role
with what it adds and who it suits, keeping every capability.

The page no longer needs wide mode, so it gets its "On this page" panel
back.

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:29 PM

Go back to the original capability matrix and drop the merged 3-column
table. Wrap the matrix in a role-matrix div and override Mintlify's
150px cell minimum for that table only, so it fits next to the "On this
page" panel without wide mode.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@hlenke hlenke changed the title docs(admin): merge the role tables into one 3-column table docs(admin): fit the role matrix next to the On this page panel Nov 2, 2026
@hlenke
hlenke marked this pull request as ready for review November 2, 2026 22:32
@hlenke
hlenke merged commit 2014967 into main Nov 2, 2026
9 checks passed
@hlenke
hlenke deleted the hannes/team-roles-table branch November 2, 2026 22:44

This branch was successfully deployed

1 active deployment
staging — d9f91dcd 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