This feedback related to the design system doc spec has been lingering in my mind. I agree. It can be much better—but I think it'll need a start-from-scratch effort. But no better time than now.
PJ Onori
@pjonori.com
I work on and write about design systems. Purveyor of fine typos.
I don’t know how I can more diplomatically say that Figma’s autolayout is a mess without watering down the sentiment.
The design system documentation spec project is now a proposed W3C community group. www.w3.org/community/bl... Big thanks to Cassondra Roberts for the suggestion.
Proposed Group: Design System Documentation Community Group | Community and Business Groups
w3.org
That episode where we make a comment offhand how this episode isn't about AI and then repeatedly talk about AI. Listen here: podcasts.apple.com/us/podcast/d...
Ep 104: The Governance Junk Drawer
Podcast Episode · Design System Office Hours · July 22 · 35m
podcasts.apple.com
Week of July 19, 2026 https://designsystems.news/#week-2026-7-19 Links by: @mitsuhiko.at
Here's a preview of the new DSDS docs site. designsystemdocspec.org Don't tell anybody though.
Design system doc spec 0.15.2
A machine-readable format for design system documentation. DSDS structures components, tokens, themes, foundations, patterns, and guides as a single source of truth for humans, parsers, and agents.
designsystemdocspec.org
The initial DSDS site is not something I'm proud of. It's not well written, overly complicated, and just a big ball of meh. I'm working to fix that with a full copywriting pass and improved docs site. Hoping to have something public by next week.
Design system spacing tokens and guidelines have typically been one of those, “we tried our best” topics. But I think I may stumbled on a model that could actually produce something useful. Excited to give it a go.
The country’s leadership has lost its damned mind.
Hegseth announced they're gonna start screening for T and administering testosterone treatment for warriors found wanting
If you’re a software engineer, designer, or technologist who wants to help make City government work better and faster, apply to join our PIT crews at nyc.gov/pitcrew.
Lucky number 0.14.0 released for designsystemdocspec.org This release rolls in a bunch of breaking changes into one rip-off-the-bandaid version. I also wanted to call out my thanks to Afyia Smith (afyiasmith.co) and Suleiman Ali Shakir (iamsuleiman.com) for their contributions!
Design System Documentation Spec 0.14.0
A machine-readable format for design system documentation. DSDS structures components, tokens, themes, foundations, patterns, and guides as a single source of truth for humans, parsers, and agents.
designsystemdocspec.org
I declare that I will solve literally every problem that has ever existed in the next 5 years. Just give me all your money now and it’ll totally, totally, totally happen.
The billionaire CEO said the company planned to land astronauts back on the moon in the next few years, before eventually building a permanent “metropolis” on its surface.”
Turns out design systems are the easiest thing to do in the history of things. podcasts.apple.com/us/podcast/t...
Two idiots talk design systems
Technology Podcast · Behold, all you lowly design system practitioners! Drop everything you're doing and consume the wisdom of two totally-not-AI thought leaders discuss deep design system topics. Enj...
podcasts.apple.com
The whole situation with Egypt in the World Cup shows how corruption hollows out an institution. It doesn’t matter whether wrongdoing occurred. The fact is anyone with a brain would at least doubt the legitimacy of the results after the bullshit with the US red card.
I see no obvious benefit to society for children’s games to have in-app purchases, loot boxes, or micro transactions.
A person saying they understand Design Systems because they know React is like someone saying that they understand cars because they know about gas.
Week of July 5, 2026 https://designsystems.news/#week-2026-7-5 Links by: @renderg.host
This idea is either horrible, hilarious, or both. podcasts.apple.com/us/podcast/t...
Two idiots talk design systems
Technology Podcast · Behold, all you lowly design system practitioners! Drop everything you're doing and consume the wisdom of two totally-not-AI thought leaders discuss deep design system topics. Enj...
podcasts.apple.com
Up to 0.13.0 in the Design System Documentation Spec. designsystemdocspec.org The first contribution was added in. Excited to see the progress continue.
Design System Documentation Spec 0.13.0
A machine-readable format for design system documentation. DSDS structures components, tokens, themes, foundations, patterns, and guides as a single source of truth for humans, parsers, and agents.
designsystemdocspec.org
Can someone give me a primer on INP benchmarks and what good looks like? This metric is new to me.
Week of June 28, 2026 https://designsystems.news/#week-2026-6-28 Links by: @jim-nielsen.com
I just had an AI tell me I suck. Politely, but unmistakably. About damned time.
I have so many typos and grammatical errors in my blog posts. It's embarrassing.
Week of June 21, 2026 https://designsystems.news/#week-2026-6-21 Links by: @terriblesoftware.org @gerireid.com