Public Surfaces Should Route, Not Recite
A personal site, GitHub profile, and short notes should route people to the right depth instead of each trying to retell the whole story.
Most public profiles try to do too much in one place.
They read like a compressed biography, a portfolio, a link list, and a positioning statement all stacked into the same surface.
That usually creates a worse outcome for everyone.
The person skimming does not know where to go next.
The person who wants proof has to hunt for it.
And the person maintaining the thing ends up rewriting the same explanation three different ways.
I think public surfaces work better when they act more like routing layers.
What each surface is good at
A site is good for shape.
It can show a point of view, present a few paths through the work, and make the deeper material easier to find.
A GitHub profile is good for practical credibility.
It gives people a faster read on whether the work is real, how small or sharp the tools are, and what I tend to build when I care enough to publish it.
A short note is good for portability.
It lets one idea travel without forcing someone to read a full case study first.
What I try not to do
I do not want every surface to repeat the same paragraph about who I am.
I do not want the site to become a giant archive with no obvious entry points.
I do not want the code to sit alone without any explanation of the workflow opinion underneath it.
Those are all different failure modes of the same problem.
The surfaces are present, but they are not connected.
What good routing looks like
Good routing is pretty simple.
Someone should be able to land on one surface, understand what kind of work they are looking at, and move one level deeper without friction.
That might mean:
- a GitHub repo that points back to a case study or note
- a short note that points to a practical tool
- a site homepage that separates writing, case studies, and code instead of blending them together
That is the bar I care about.
Not maximum completeness.
Just enough structure that the right person can find the right depth quickly.