Start here

Most blogs greet you with a grid of cards and a photograph of someone looking thoughtfully out of a window. This one greets you with a directory listing, because I spend most of my day inside one and it felt dishonest to pretend otherwise.

You are, appropriately, reading the README.

Why this exists

Everything I do professionally eventually gets written up properly: the problem, the approach, the tidy outcome, the screenshot where the numbers went up. Those write-ups are true. They are also edited, and what gets edited out is the only part I have ever found useful in someone else’s.

The three days of being confidently wrong. The bug that turned out to live in a file nobody suspected. The detail that ate an afternoon and that precisely zero users will consciously notice, but which they would absolutely have felt if it were missing.

That is what goes here. Not a portfolio — a workbench, with the shavings still on it.

How it is arranged

The sidebar mirrors the folders on disk. There is no clever taxonomy and no tag cloud shaped like a weather system. Adding a category means making a folder.

• engineering/ — things that broke, and what they cost to find.
• craft/experiments/ — small interaction details. Usually invisible. Occasionally worth an entire afternoon.
• notes/ — running lists and half-finished thinking. Updated when something earns its place rather than on a schedule.
• misc/ — the drawer. Every house has one.

Some of those are empty at the moment. They are shelves, and the books are in progress. I would rather show you the shape of the thing than hide it behind a curtain until it is full.

What a post can do here

Posts are documents and components at the same time. When something is easier to understand by poking it, you can poke it — a real, running thing sitting in the middle of the paragraph that describes it, not a screenshot of one.

Anything that can be explained faster by letting you touch it should be something you can touch.

Two things worth knowing

The marks down the right edge are how far through a post you are. They fill as you read and fold back into a single line when you reach the end.

When you do reach the end, something in the corner will lean over and suggest what to read next. If you would rather not be told, you can pick it up and throw it across the screen. It bounces.

That’s the tour

No newsletter, no modal sliding in from the bottom right to ask about a relationship we both know is not going anywhere. Just files.

Pick a folder.