Palmshed

Writing

Articles

Long-form engineering writing on maintainable systems, developer tools, open source, and the practice of building software that lasts.

Articlebuilding-in-public

Building in Public, Honestly

Building in public is not posting wins. It is showing the work (the false starts, the trade-offs, and the small decisions), and letting the process be the content.

Read Sep 2, 2026
Articledebugging

Reading Code With Intention

We are taught to write code, rarely to read it. But reading is most of the job, and it is a skill that improves like any other.

Read Aug 26, 2026
Articleengineering-practice

The Art of the Small Change

Big changes are hard to review, hard to roll back, and hard to reason about. The small change is the unit of safe engineering.

Read Aug 5, 2026
Articlerefactoring

Refactoring As Communication

A refactor is a letter to the next engineer. Every rename, every extracted function, every deleted comment is a sentence in it.

Read Jul 29, 2026
Articlearchitecture

Designing Maintainable Systems

The architecture that survives is the one that anticipates change, not by predicting the future, but by making change cheap.

Read Jul 22, 2026
Articleopen-source

Lessons From Open Source

Open source taught me more about engineering than any course did, not because the code is better, but because the process is real.

Read Jul 15, 2026
Articledocumentation

Documentation Is Engineering

Documentation is not a chore that follows the real work. It is the real work, done in a form that other people can use.

Read Jul 8, 2026
Articlemaintainability

Building Software That Lasts

The longer I build software, the less I believe writing code is the difficult part. Keeping software understandable, maintainable, and adaptable is.

Read Jul 1, 2026