W27 · Pin Down the Vague.
One concept, three names, three layers — so nothing lined up. This week I pinned it down.
Ask AI
Three names, one thing.
The same thing was a series in the content layer, a category in the API, and a topic in the client. Each layer was coherent on its own. Together they simply did not connect.
The break was concrete: the client asked using a topic id, the API matched on categories, and the content had never heard the word. The list came back empty, every single time.
Vagueness bills you at integration.
Inside any one layer the name barely matters — context carries it. The bill arrives at the boundary, and by then all three sides have already been written.
Which is why naming is not aesthetics. It is an interface. It decides whether two modules can speak to each other at all.
What I did this week.
Collapsed the three vocabularies into one: series. The id is its slug, a series is a column, and a column is an entry point. Every middle layer got deleted.
— Discussion
GitHubComments.
Comments are powered by GitHub Discussions. Keep the conversation focused and respectful.
Comments did not load this time. Refresh to retry, or join the discussion directly on GitHub.