Documentation foundations for humans and AI
Before we rush to optimise our docs for AI, we need to get the foundations right.
Blog
Writing helps me untangle my thoughts. I write about accessibility, design systems, and user experience.
If you use a feed reader, here’s my RSS feed.
Debug: blogPosts=17, externalPosts=6
- May 2026
- April 2026
Making product documentation work for humans and AI
Companies are investing heavily in AI. This feels like our chance to quietly make documentation better for everyone.
- February 2026
AI is accidentally making documentation more accessible
Writing documentation for AI retrieval improves accessibility for humans too.
- January 2026
Don't leave the screen reader hungry (opens in new tab)
Screen readers don’t always announce what’s visually on screen. This article explores that gap - through the medium of burritos. Published on the HTML Hell Advent Calendar.
- December 2025
How to annotate design system components for accessibility (opens in new tab)
Here's a process for documenting accessibility requirements when you build design system components - what to annotate, how to create reusable specifications, and why machine-readable formats unlock greater value than sticky notes. Published on the zeroheight blog.
- November 2025
Can AI write accessibility specs?
I wrote a prompt to help me write accessibility specs for components. Then had an existential crisis.
- October 2025
Add an Accessibility Nutrition Label
I've just completed an app audit for an iOS accessibility nutrition label. Here's what I learned.
- September 2025
Turns out I'm not ready to write a book
Sometimes the universe puts wise people in your path to point out the obvious. Like maybe start with a blog before committing to 50,000 words.
- August 2025
What’s the EAA got to do with my design system? (opens in new tab)
Confused about the European Accessibility Act (EAA)? Not sure whether it applies to your design system or if you’ve missed an important deadline? Here's a post I wrote for the zeroheight blog.
- June 2025
How blind customers experience our app (opens in new tab)
Insights from user testing our Just Eat iOS app with a blind customer - on the Just Eat Medium Tech blog.
- February 2025
Designing for dyscalculia and low numeracy
Reflections on dyscalculia and practical ways to make numbers more accessible.
- March 2024
WCAG for designers
A practical, jargon-free guide to the Web Content Accessibility Guidelines (WCAG).
- March 2024
Foundations for the BPP design system
How we set up the core styles and tokens for BPP’s education-focused design system.
- June 2023
- June 2023
How to create accessible design system components (opens in new tab)
Guest blog for SuperNova on how to prioritise accessibility when building design system components.
- March 2023
How to write an accessibility statement
A practical guide with examples and resources to help you write an accessibility statement.
- October 2022
Designing an Accessible Future
I did a talk at WDC exploring WCAG 3.0, Web3, and the future of inclusive design.
- September 2021
Scaling accessibility with a design system
Designing accessible components and scaling their impact through a design system.
- June 2021
5 things I learned building Constellation
Reflections from 3.5 years building Lloyds Banking Group’s multi-brand design system.
- February 2021
Halifax digital rebrand
How we translated a new visual identity into accessible, flexible UI components for Halifax.
- February 2020
Building Constellation
How we created and scaled Lloyds Banking Group’s multi-brand design system from the ground up.
- January 2020
First rule of Design Club
What I learned running design thinking workshops with teenagers in a London secondary school.
- March 2019
Meet the Mentor (opens in new tab)
An intro post for the Design Club Medium blog, sharing a bit about me and why I got involved