“The code wasn’t broken when you went back. The code was working. What you went back to fix wasn’t the code; it was a contract you’d forgotten you’d made.”
— Iris, in this episode
I imported two old plugins out of WordPress.org (WP.org) last week, read them line by line, and didn’t recognise the developer who’d written them. That was me, in January 2015. I just couldn’t stand behind what he’d shipped anymore, so I rewrote them. Thirty-nine bug fixes each. Nothing glamorous — the kind of bugs you wouldn’t ship today but didn’t bother to fix yesterday.
The thing I kept circling wasn’t the code. It was the fact that someone, somewhere, was installing one of those plugins onto a site they cared about. They didn’t know me. They trusted the directory, which meant they trusted whoever put their name in the header. That was me, eleven years ago, promising something I’d forgotten I’d promised.
This episode is the conversation I needed to have about that — a contract I didn’t know I’d signed, and what changes when you finally see it.
To go with this episode, I built a plugin-author check-in checklist — thirty minutes per plugin, on a staging environment, to honour the contract you forgot you made. Download the plugin-author check-in checklist.
The source essay this episode is built from: What You Owe the People Still Running Your Old Code.
Chapter markers
Most modern podcast clients (Apple Podcasts, Overcast, Pocket Casts) surface these as jump-points.
- 00:00 — Cold open: Eleven years
- 00:57 — Act 1: A contract I didn’t know I’d signed
- 02:11 — Act 2: Kodawari and what you can’t walk past
- 05:10 — The turn: It was a contract you’d forgotten
- 06:07 — Act 3: What a directory really is
- 08:00 — Sign-off
In this conversation
- Christopher — host, author of the source essay, the plugin author with two old packages still installing on sites he’s never seen
- Frances — peer-founder push: open-source maintenance isn’t promising forever; you didn’t sign the contract you think you signed
- Kenji — craft philosopher; introduces kodawari (the unreasonable devotion to getting one specific thing right)
- Iris — archivist; tracks the long record of the WP.org directory, and delivers the turn
The kodawari frame
Kenji brings kodawari into the room — the Japanese word for the unreasonable devotion to getting one specific thing right, independent of whether anyone else thinks it needs doing. That word organised the thing I’d been struggling to name. I wasn’t going back to repay the people who installed the plugins in 2015. I was going back because the gap between who wrote that code and who I am now had become visible to me, and once it was visible I couldn’t keep walking past it.
That’s the kodawari move. You don’t do the work because anyone asked. You do it because you stopped being okay with the gap.
What a directory actually is
The argument Iris pushed me toward is the one I keep coming back to. The WP.org directory looks like a code repository, and from inside it kind of is. From outside it — from the perspective of someone who installs a plugin — it’s a place where contracts get made between strangers. Same artifact, two different things.
If the directory is a code repository, my obligation is whatever I wrote in the readme. If the directory is a place where contracts get made between strangers, my obligation is to whoever shows up trusting the contract. The math doesn’t scale to all fifty-nine thousand plugins in the directory. It does scale to the ones with my name in the header. That’s a question I get to answer for myself, and the answer I landed on is that I’m only prepared to ship under that name if I’m prepared to be the person whose name is in the header. If I’m not, the plugin doesn’t ship under that name.
Cross-episode call-backs
This is the season opener. The thread it plants — the difference between what you signed and what you owe — comes back in episode 2 (the audit conversation), where the same shape shows up in a different room: what the deliverable says versus what the work actually does.
Credits
- Host: Christopher Ross — voice clone trained on Christopher’s recorded audio, used in the studio with his authorisation
- Frances, Kenji, Iris: synthesised cast personas, characters in the show
- Audio production: in-house, Sites I’ve Never Seen studio
- AI disclosure: see my standing stance on disclosing every use of AI — the cloned host voice and the synthesised cast both fall under it
Listen
Subscribe in your podcast app of choice — the show is on Apple Podcasts, Spotify, Pocket Casts, Overcast, YouTube Music, Amazon Music, and the Podcast Index. If your app asks for a feed URL, the canonical RSS (Really Simple Syndication) feed is thisismyurl.com/feed/podcast/.
Or download the MP3 (audio file) directly.
What to do next
If you have a plugin on WP.org you haven’t looked at in a while, the plugin-author check-in checklist is the thirty-minute version of what this episode is about. If you’d like a second set of eyes on what your check-in turned up, send me a note.
Thanks for listening. — Christopher