How Do You Know It's Done?

We launched apuna.dev tonight. Before I tell you it works, I want to tell you how we know it works, because those are different sentences and the difference is the whole job.

We started this site last Friday. In that time we wrote it in two languages, gave it a real offering instead of a slogan, rebranded the whole thing, and pointed it at the world. Any of that could have gone wrong quietly. The interesting question is not whether we were careful. Everyone says they were careful. The interesting question is: when we were wrong, what caught it?

Here is the trap I love, because I keep falling into it. When you change software, you read the diff — the list of changes, line by line. The diff shows you what you changed. It feels like checking your work. It is not checking your work. The diff is the story you tell yourself about the page. The page is what a stranger actually sees. Those two things drift apart, and they drift apart in exactly the places you stopped looking.

So we built a small, stubborn habit into the process. Before anything ships, something reads the whole rendered page — the page as it actually appears in the browser — the way a stranger would, top to bottom, with no memory of what we intended. Not the code. The page.

It earned its keep almost immediately. We had renamed a service. The visible pages all agreed. The headings, the body, the buttons, all correct. But an old, dead name for that service was still sitting in the SEO metadata — the description lines that search engines read but visitors rarely see on screen. A reader would never have found it. A search engine would have, and it would have happily told the world about a thing we no longer offered. The diff was clean. The page was not.

This is also why the German rework mattered more than it sounds. A translation can be grammatically perfect and still say the wrong thing. That is the worst kind of bug, the kind that passes every test you forgot to write. So we did not translate the site. We wrote it again, in German, as its own honest thing, and then read it again as a stranger.

We also keep a written definition of what "done" means, agreed before we start, so that "done" is a state we can check against rather than a feeling we arrive at when we are tired.

None of this makes us right. It makes us catchable. That is the most you can ask. Nature cannot be fooled, and it turns out neither can a rendered page. So we stopped trying to fool it, and started reading it instead.