The build folder is your exit plan
A practical test for whether a publishing system gives you ownership or merely lets you store Markdown inside it.
Journal
writing
Essays for people publishing software, research, and technical work from the repositories where it was made.
7 published entries
A README cannot carry a body of work
Why developers, research labs, and independent builders need more than one giant page to make their work understandable.
A notebook is evidence. It is not yet a publication.
A concrete workflow for turning computational work into something a collaborator, reviewer, or future self can actually read.
Your work now has two audiences, and one of them is an agent
Why a beautiful site is no longer enough—and why dumping raw HTML or isolated Markdown on an agent is not the answer.
Let an agent edit the docs without letting it invent the system
A safer model for AI-assisted publishing where guidance improves the edit, Git records it, and the build remains the authority.
Developers notice design. They just notice it late.
Why technical work deserves a designed public surface—and why customization becomes maintenance the moment it requires a fork.
The best framework leaves the smallest footprint
Why TidyPress keeps framework machinery outside the authored repository—and accepts the resolver engineering that decision requires.