Skip to content

fix(docs): write the design tokens post in the first person - #96

Merged
alexgrozav merged 1 commit into
mainfrom
blog-first-person-uxf-883
Nov 19, 2026
Merged

alexgrozav merged 1 commit into
mainfrom
blog-first-person-uxf-883

Conversation

@alexgrozav

Copy link
Copy Markdown
Contributor

What changed

The first blog post, "How to name design tokens", is written by Alex, so it now speaks as him: "I" rather than "we". Two sentences said "we" and "our", and both now say "I", with the Design Tokens page named as the Open Components page that defines token paths. The "Let's start with…" openings stay, since they mean the author and the reader together.

The frontmatter description now calls token paths a convention: "How I name design tokens so people, tools and agents read them the same way, using the token paths convention, step by step and with worked examples." It's 149 characters, inside the 70 to 160 that check-seo asks for, and it feeds the meta description, og:description and the post's JSON-LD.

It also adds the full stop missing after button › icon › size. Nothing else changes: the title, headings, examples and counterExamples stay as they were.

Checklist

  • The title follows Conventional Commits, as in feat(docs): add the focus guideline.
  • pnpm check-types passes.
  • Docs changes: the pages read well on pnpm dev. (Not run: a copy-only change to one post. pnpm build and pnpm check-seo pass, and the built page carries the new description and sentences.)
  • Homepage changes: pnpm build, then pnpm lighthouse, still scores 100 in every category. (No homepage changes.)

The post is Alex's, so it says "I" rather than "we", and its description now names token paths as a convention.

Co-authored-by: multica-agent <github@multica.ai>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 19, 2026 •

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://blog-first-person-uxf-883.opencomponents.dev, https://blog-first-person-uxf-883-opencomponents.blue-water-0397.workers.dev (commit 42c0242)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://eb6e9386.opencomponents.dev, https://eb6e9386-opencomponents.blue-water-0397.workers.dev 42c0242 2026-11-19T07:13:13.465Z Visit the dashboard ↗

@alexgrozav
alexgrozav marked this pull request as ready for review November 19, 2026 07:16
@alexgrozav
alexgrozav merged commit a7bf34f into main Nov 19, 2026
5 checks passed
@alexgrozav
alexgrozav deleted the blog-first-person-uxf-883 branch November 19, 2026 07:37
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