Skip to content

style(docs): give standalone screenshots room to breathe - #1108

Merged
davidesner merged 2 commits into
mainfrom
docs/screenshot-spacing
Sep 3, 2026
Merged

davidesner merged 2 commits into
mainfrom
docs/screenshot-spacing

Conversation

@KaroEverling

Copy link
Copy Markdown
Contributor

Jira issue(s): PROOF-XXX

Screenshots currently sit as tight against the surrounding text as an ordinary paragraph does, which reads cramped on image-heavy pages.

Changes:

  • One rule in custom.css: margin-block: 2rem on paragraphs whose only child is a zoomable image.

Scoped deliberately. Table icons sit in <td> rather than <p>, so icon columns like the ones on /kai/settings/ and /kai/getting-started/ keep their tight spacing. Inline images are unaffected for the same reason.

Verified on /kai/settings/, which has 13 images across both kinds:

Element Computed margin
Standalone screenshot 32px / 32px
Table icon cell 0 / 0
Normal paragraph 0 / 0

Split out of #1107 so the Kai content there stays reviewable on its own. This is site-wide, every screenshot on help.keboola.com, so it deserves its own look rather than riding along in a content PR.

Two things worth a second opinion:

  1. 2rem is a guess. It looked right on the Kai settings page; someone with an opinion on the type scale may prefer 1.5.
  2. The selector uses :has(). Well supported in current browsers, and it degrades to today's behaviour if unsupported rather than breaking. I have only checked it in dev, not in a production build, so it is worth a look on the Vercel preview given the view-transition caveat in CLAUDE.md.

Screenshots sat as tight against the surrounding text as a paragraph
does, which reads cramped on image-heavy pages.

Scoped to images that are alone in their paragraph, so table icons
(which sit in <td>) and inline images are unaffected.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@vercel

vercel Bot commented Aug 31, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
connection-docs Ready Ready Preview Sep 3, 2026 11:17am UTC

Request Review

@linear-code

linear-code Bot commented Sep 3, 2026

Copy link
Copy Markdown

AI-3458

@davidesner davidesner left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@davidesner
davidesner enabled auto-merge September 3, 2026 11:16
@davidesner
davidesner merged commit 8112714 into main Sep 3, 2026
3 checks passed
@davidesner
davidesner deleted the docs/screenshot-spacing branch September 3, 2026 11:17

This branch was successfully deployed

1 active deployment
Preview — 98ffdf1f Deployed Sep 3, 2026 by vercel[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.

2 participants