Skip to main content
Settings
Search
Appearance
Theme Mode
About
Jekyll v3.10.0
Environment Production
Last Build
2026-06-29 03:45 UTC
Current Environment Production
Build Time Jun 29, 03:45
Jekyll v3.10.0
Build env (JEKYLL_ENV) production
Quick Links
Page Location
Page Info
Layout article
Collection posts
Path _posts/2021-11-08-it-purpose-manifesto.md
URL /posts/2021/11/08/it-purpose-manifesto/
Date 2021-11-08
Theme Skin
SVG Backgrounds
Layer Opacity
0.6
0.04
0.08

An IT Manifesto: Why I Keep Building the Map I Wish I'd Had

Field Notes

You probably landed here mid-crisis.

You typed something into a search bar at an hour you’d rather not admit to, looking for the one command, the one config line, the one paragraph that makes the current thing stop being broken. Or maybe you’re at the other end of it — standing at the edge of the IT jungle for the first time, trying to figure out which direction is even forward.

Either way: I don’t have the quick fix you came for. Not in this post, anyway.

What I have is a reason I keep writing any of this down at all, and I figured I’d put it somewhere I can point at later. This is that.

The thing I actually wanted never existed

Every layer of this field is its own little universe. Networking has its own gravity and its own dialect. So does the OS underneath it, the database next to it, the build pipeline strapped on top of it, the cloud bill at the bottom of all of it. Each one demands real understanding and its own pile of tools merely to keep running. You can master any of them. You cannot master all of them, and anyone who tells you they have is selling something.

So you do what everyone does. You keep notes. Scattered ones. A ~/notes.txt here, a starred Stack Overflow answer there, a screenshot of a config you’ll never find again. The map exists, technically. It’s in forty pieces across six machines and none of them talk to each other.

What I wanted was the consolidated version. One place that was a roadmap and a toolkit and a dictionary and a manual and a cheatsheet and a drawer of code snippets, all at once, that didn’t assume I already knew the thing I was looking up. I went looking for it. It wasn’t there in the shape I needed.

This is me building it instead — mostly for myself, and honestly, partly out of spite.

Built for me first. That’s the feature, not the apology.

I want to be straight about the order of operations, because most “we’re building this for the community” mission statements have it backwards.

I am building this so that I stop relearning the same things. The future version of me who has forgotten exactly how DNS resolution actually orders its lookups is the primary customer. Everything here gets written to the standard of “would this have saved me the two hours I just lost?” If the answer is no, it doesn’t earn a page.

The nice part — the part that makes it worth doing in public instead of in a private gist — is that effort spent learning something alone is mostly wasted until it’s shared. The hours I spend untangling a problem are sunk either way. Writing them down is the only move that pays them back more than once.

So the goal is the genuinely hard combination: comprehensive enough to serve someone at any skill level, and still readable enough that a beginner isn’t drowning by paragraph two. Those two goals are in permanent tension. I don’t have that solved. I’m flagging it as an open problem, not a delivered promise, because pretending it’s solved is how you end up with documentation that’s “complete” and “thorough” and also completely useless to the person who actually needs it.

What this is not

It is not the single source of truth for all things IT. Nothing is, and anything claiming to be should make you nervous. The field moves; today’s authoritative answer is next year’s deprecated flag. Treat anything here — anything anywhere — as a snapshot with an expiry date I haven’t printed on it.

It is not a substitute for the official docs, the man pages, or actually reading the error message. It’s the layer on top: the connective notes between all those sources, written in plain language, with the dead ends left in.

And it is not finished. It’s a repository that grows by accretion, one solved problem at a time, which means it will always be partly wrong and partly out of date. That’s not a defect of this particular effort. That’s what a living reference is.

The whole ask

If something here saves you the two hours it would’ve cost you, good. That was the entire point.

And if you ever build your own version of the map — your own notes, cleaned up and put somewhere another person can find them — pay it forward. The jungle is large enough that no one clears a path through it alone, and the only knowledge worth having is the kind that survives being handed to someone else.

That’s the manifesto. There’s no part two. Go fix your thing.