AI transparency

AI plays three roles in this project:

Editor. The primary reason I write this manually is the pure joy of it. But English grammar is not my strongest suit, and AI has been a useful second pair of eyes for catching bad spelling, clumsy sentences, and awkward transitions. Sometimes I even use it to rewrite entire paragraphs for me from my drafts. But what I can guarantee is that I have read and reread every word of this guide until I was satisfied it reflected my intent.

Critic. I use AI-as-a-judge to cross-reference this work against well-established sources — a first-pass agent for punching holes in the security reasoning before humans do.

Developer. I’m a software engineer by day, but I don’t hand-craft infrastructure the way I used to. I used Claude to build the Hugo-based site that pulls content from the corresponding Obsidian notebook — a workflow I can highly recommend.

Backwards compatibility

Currently the guide is not versioned. I’m hoping that before it sees any kind of adoption it will be relatively stable, such that I don’t have to introduce breaking changes — the guide will always have to assume that someone might be relying on it. If I do have to make a breaking change, I will version it and allow the reader to globally select a version. The source of this guide is open source and the history can be retrieved in a pinch by going through the commit history. TODO: This is not true yet. The guide is not stable.

Visitor tracking

This site does not employ any kind of visitor tracking. No Javascript. No Google Analytics. No cookies. This is deliberate.

Engagement as a number is not an important metric here. Engagement as a relationship is. If something in this guide helped you, or if something is wrong, or if you have built on it in some way — that is worth far more than a pageview. Get in touch.

How this site is built

Built with Hugo, a static site generator. The source is plain Markdown files. See the License page for terms of use.

Use at own risk

Finally, it should go without saying, that I can’t take responsibility for how you chose to engage with this material. As I mentioned in the introduction, by publishing this for all to see, so I’m putting skin in the game. That should at least help motivate that this is not just another attention seeking piece of internet slop. But the whole point of this guide is to enable you to take responsibility rather than pass it off to someone else.