A notebook, not a publication

Why this site exists, what will end up on it, and the one rule I'm giving myself about publishing.

A placeholder image standing in for a photograph.

I’ve been writing iOS apps for six years and taking notes for about as long. The notes live in four places: a Things inbox, a folder of untitled Markdown files, the margins of a paper notebook, and — mostly — nowhere, because I never wrote them down.

This site is the fifth place, and the plan is that it replaces the other four.

Swift and SwiftUI, mostly, because that’s what I do all day. But the posts I actually want to write are the ones that don’t fit in a commit message: why a refactor was worth it, why the obvious solution was wrong, what a framework is quietly bad at. Short pieces about work that was long.

There will be detours. I rebuilt this site’s design around Portuguese azulejos, which has nothing to do with iOS and everything to do with why I enjoyed building it.

The one rule

Publish it before it’s finished.

Every unfinished draft I’ve written has been a better post than the polished one I never started. So the bar here is deliberately low: if a note is useful to me in six months, it goes up. The opinions are provisional and I reserve the right to change my mind in public.

How it’s built

Swift, end to end. The site is a static site generated by Ignite, the posts are Markdown files in a folder, and the whole thing is a swift run away from being HTML. The fonts are served from this domain rather than from Google, and there is no analytics and no cookie banner, because there are no cookies.

That’s the whole stack. If you want to talk about any of it, the links are at the top of the page.