Skip to content

[DX-1527] Typography and spacing enhancements#3469

Open
m-hulbert wants to merge 3 commits into
mainfrom
docs-styling-updates
Open

[DX-1527] Typography and spacing enhancements#3469
m-hulbert wants to merge 3 commits into
mainfrom
docs-styling-updates

Conversation

@m-hulbert

@m-hulbert m-hulbert commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

Description

This PR implements some new rules for typography and spacing throughout the docs site. Spacing between components, headings and paragraphs should be consistent now that we are no longer inheriting styles from the marketing site.

Checklist

@m-hulbert m-hulbert self-assigned this Jul 13, 2026
@m-hulbert m-hulbert added the review-app Create a Heroku review app label Jul 13, 2026
@coderabbitai

coderabbitai Bot commented Jul 13, 2026

Copy link
Copy Markdown

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro

Run ID: 559fedab-f69c-414c-9d61-119a98799d22

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch docs-styling-updates

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@ably-ci ably-ci temporarily deployed to ably-docs-docs-styling--d7iagd July 13, 2026 13:58 Inactive
m-hulbert and others added 3 commits July 13, 2026 16:26
Align heading sizes (h1 32, h2 24, h3 20, h4 18, h5 16px), grid-aligned
line-heights and graded letter-spacing with the new docs type scale. Set
monospace text to medium weight, add a serif ui-text-sub-head style
(adopted by the page header intro), and restyle the inline code chip.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Replace the symmetric heading and paragraph margins with an asymmetric
rhythm: a larger top margin separates a heading from the preceding
content and a smaller bottom margin sets the gap to the following text.
Move body copy from p2 to p1 and give code blocks and images 24px of
vertical spacing.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Use 24px vertical spacing for tables and admonitions and set table body
text to 15px (p2).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@m-hulbert m-hulbert force-pushed the docs-styling-updates branch from a515daa to f1f99af Compare July 13, 2026 15:31
@m-hulbert m-hulbert changed the title Typography and spacing enhancements [DX-1527] Typography and spacing enhancements Jul 13, 2026
@m-hulbert m-hulbert marked this pull request as ready for review July 13, 2026 16:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

review-app Create a Heroku review app

Development

Successfully merging this pull request may close these issues.

2 participants