PACIFIC STANDARDS
Back to the studio

Opinion

Plain language is a feature

Every deliverable we write can be read by the person who signs the invoice. That sounds like a style preference. It's actually an engineering constraint, and it changes what gets built.

Here's the logic. If a system can't be explained in plain language, its owner can't trust it, staff can't maintain it, and the next consultant will happily bill you to rediscover what it does. Complexity you can't narrate is debt. It compounds quietly, like all debt, and it comes due the day the one person who understood the thing goes on vacation.

So we write the explanation first. Before the build, sometimes before the quote. If the explanation won't hold in two paragraphs, the design isn't done, and no amount of clever code fixes an idea that can't survive being said out loud. The prose is the spec.

There's a useful version of this you can run on your own operation, and it takes ten minutes. Pick the most important system in your business, whatever software or process everything else leans on, and explain it out loud to nobody. Where you hesitate, where you say "and then it sort of", where you trail off entirely: that's where the debt lives. It's also, not coincidentally, where the fixes live. We spend a lot of our assessments listening for exactly those pauses. You can hear yours for free.

Back to the studioNext story