Skip to content

fix(docs): release 0.15.2 with shorter, quieter inline code - #204

Merged
tmccoy14 merged 1 commit into
mainfrom
fix/docs-inline-code-size
Oct 22, 2026
Merged

tmccoy14 merged 1 commit into
mainfrom
fix/docs-inline-code-size

Conversation

@tmccoy14

Copy link
Copy Markdown
Contributor

Need

Inline code in docs prose is too tall and too loud. On code-heavy pages it collides with the lines around it and stands out more than the prose does.

Problem

  • p-1 makes each code box 26px tall on a 24px list line, so code on neighboring lines overlaps by 2px. Measured with Playwright on the Guardian docs.
  • The full neutral Badge background turns every code span into a solid grey block, which dominates dense passages, especially in dark mode.

Change

  • Padding is now 2px above and below and 4px on the sides. Code boxes are 22px tall on a 24px line, so neighboring lines no longer touch.
  • Code is sized at 0.875em, relative to the surrounding text. It still renders at 14px in body text.
  • The background is the neutral Badge color at 50% opacity. Code keeps the Badge text color, so it stays in the same color family fix(docs): release 0.15.1 with inline code in the neutral Badge colors #203 chose, but recedes.
  • Released as 0.15.2, with a changelog entry.

Testing

  • The @eqtylab/docs build passes, and all 218 docs tests pass.
  • Compared before and after on the Guardian docs in light and dark mode, by swapping this CSS into a local preview and capturing it with Playwright.

Not covered

  • At 50%, inline code no longer exactly matches a neutral Badge placed right beside it. Prose rarely does that, so we chose the quieter look.

🤖 Generated with Claude Code

Inline code was 26px tall on a 24px list line, so code on neighboring
lines overlapped. It now has 2px of vertical padding, is sized relative
to the surrounding text, and sits on the neutral Badge background at 50%
so code-heavy passages read as prose first.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@tmccoy14
tmccoy14 merged commit 6d748db into main Oct 22, 2026
1 check passed
@tmccoy14
tmccoy14 deleted the fix/docs-inline-code-size branch October 22, 2026 19:29
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