Skip to content

fix: stop skill name overflowing/overlapping the description#88

Merged
TMHSDigital merged 1 commit into
mainfrom
fix/skill-name-overflow
Jun 20, 2026
Merged

fix: stop skill name overflowing/overlapping the description#88
TMHSDigital merged 1 commit into
mainfrom
fix/skill-name-overflow

Conversation

@TMHSDigital

Copy link
Copy Markdown
Owner

The bug (confirmed on live fleet sites)

The Skills accordion renders .skill-name with white-space:nowrap + min-width:140px inside a non-wrapping flex <summary>. The flex algorithm shrinks the name's box toward 140px (the min-width lowers its min-content floor), but nowrap keeps the text at full width — so the name's ink overflows its box and paints over .skill-desc. Seen on Blender-Developer-Tools and Plaid-Developer-Tools, desktop and mobile, in the expanded state.

Fix (CSS-only, Skills section only)

  • .skill-name: drop white-space:nowrap + min-width:140px; use flex: 0 1 12rem; min-width: 0 → an honest, wrapping column.
  • .skill-desc: flex: 1 1 auto; min-width: 0; overflow-wrap: anywhere (wraps long code tokens instead of overflowing).
  • summary: align-items: flex-start (top-align the columns); nudge the disclosure triangle to the first text line.
  • @media (max-width: 620px): flex-wrap so the description stacks full-width under the name (the two-column row is too cramped on phones).

No build_site.py / data-schema / DOM / non-Skills changes.

Verified locally BEFORE merge (floating-main → build-and-see first)

Built 3 repos with the patched template and screenshotted with headless Chrome (expanded + collapsed, desktop 1280 + mobile 390):

  • Blender & Plaid: name/description overlap gone at both widths.
  • Docker (short names): rows render correctly, no new gap/misalignment.
  • Collapsed state still hides rows; the Rules table and category headers are unchanged.

Resolves the confirmed rendering-defect subset of #86 (the facelift/examples scope stays open — do not close #86).

🤖 Generated with Claude Code

@github-actions

github-actions Bot commented Jun 20, 2026

Copy link
Copy Markdown

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

The Skills accordion rendered .skill-name with white-space:nowrap +
min-width:140px inside a non-wrapping flex <summary>. The flex algorithm
shrinks the name box toward 140px while nowrap keeps the text full width, so
the name's ink overflows its box and paints over .skill-desc. Confirmed on
multiple live fleet sites (Blender- and Plaid-Developer-Tools), desktop and
mobile, expanded state.

CSS-only fix (Skills section only):
- .skill-name: drop white-space:nowrap + min-width:140px; flex:0 1 12rem +
  min-width:0 -> an honest, wrapping column.
- .skill-desc: flex:1 1 auto + min-width:0 + overflow-wrap:anywhere (wraps
  long code tokens instead of overflowing).
- summary: align-items flex-start; nudge the disclosure triangle to the first line.
- <=620px: flex-wrap so the description stacks full-width under the name.

Verified by local build + headless screenshots across Blender, Plaid, and
Docker (expanded + collapsed, desktop 1280 + mobile 390): overlap gone,
short-name rows unaffected, collapse and the Rules table unchanged. No
build_site.py / data-schema / DOM / non-Skills changes. Resolves the
confirmed rendering-defect subset of #86 (facelift scope remains open).

Bumps VERSION 1.17.0 -> 1.17.1 and regenerates docs/index.html (the version
footer) per the repo's release-hygiene gates.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Signed-off-by: fOuttaMyPaint <154358121+TMHSDigital@users.noreply.github.com>
@TMHSDigital TMHSDigital force-pushed the fix/skill-name-overflow branch from 9027858 to 198d7b4 Compare June 20, 2026 23:03
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Jun 20, 2026
@TMHSDigital TMHSDigital merged commit 4d8f328 into main Jun 20, 2026
14 checks passed
@TMHSDigital TMHSDigital deleted the fix/skill-name-overflow branch June 20, 2026 23:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Fleet Pages: examples gallery support in the shared template

1 participant