{
"$type": "site.standard.document",
"content": {
"$type": "site.standard.content.markdown",
"text": "import InlineCallout from '../../components/InlineCallout.astro';\nimport InlineCalloutCluster from '../../components/InlineCalloutCluster.astro';\n\n## Something Feels Off\n\nIt was a class name. Part of a component I'd built a few weeks back. It worked, it was in production, nobody had looked at it twice. But every time I opened that file for something else, I'd hover over it for a second longer than I needed to. `.wrapper-inner-content`. Not wrong. Just…not quite there. Like a word you use in conversation because you can't find the right one fast enough.\n\nI renamed it on a Tuesday morning before I'd properly started the day. Took about four minutes including the find-and-replace. Closed the file, made a cup of tea.\n\nI stopped thinking about it. Which means I'd been thinking about it the whole time.",
"version": "1.0"
},
"description": "We can describe code that works. We struggle to describe code that's good. This is an attempt at the difference.",
"path": "/writing/the-aesthetics-of-code",
"publishedAt": "2026-03-13T00:00:00.000Z",
"site": "https://dominickjay.com",
"tags": [
"essays",
"opinions"
],
"textContent": "import InlineCallout from '../../components/InlineCallout.astro';\nimport InlineCalloutCluster from '../../components/InlineCalloutCluster.astro';\n\nSomething Feels Off\n\nIt was a class name. Part of a component I'd built a few weeks back. It worked, it was in production, nobody had looked at it twice. But every time I opened that file for something else, I'd hover over it for a second longer than I needed to. . Not wrong. Just…not quite there. Like a word you use in conversation because you can't find the right one fast enough.\n\nI renamed it on a Tuesday morning before I'd properly started the day. Took about four minutes including the find-and-replace. Closed the file, made a cup of tea.\n\nI stopped thinking about it. Which means I'd been thinking about it the whole time.",
"title": "The Aesthetics of Code",
"updatedAt": "2026-06-08T09:40:23.810Z"
}