Explaining Software Design explaining.software

<!-- buttondown-editor-mode: plaintext --><h3 style="text-align:center;">by <a href="https://ideolalia.com/">Zach Tellman</a></h3> For the past few years, I've been working on a book about software design. Its thesis is fairly simple: > Software development can be reduced to a single, iterative action. Almost everything we do in the course of a day — the pull requests, the meetings, the whiteboard diagrams, the hallway conversations — is an explanation. Our job is to explain, over and over, the meaning of our software: what it is, and what we expect it to become. In this newsletter, I'll be sharing some excerpts from my still-incomplete manuscript. I'll also share some tangential thoughts that didn't make the cut. Topics will include: * practical definitions for simplicity and complexity * names and metaphors * the history of software design * language models as software developers, and vice-versa If any of this sounds interesting, you should check out the [introductory post](https://explaining.software/archive/a-brief-introduction/) and subscribe.

complexity as entropy
explaining.software·48w
complexity as entropy
explaining.software·48w·
the sudoku affair
explaining.software·53w
the sudoku affair
explaining.software·53w·
state and trace
explaining.software·56w
state and trace
explaining.software·56w·
structuralism
explaining.software·57w
Structuralism
explaining.software·57w·
Discuss: Hacker News
senior developer agents
explaining.software·63w
Senior Developer Agents
explaining.software·63w·
the death of the architect
explaining.software·67w
the death of the architect
explaining.software·67w·
making things better
explaining.software·68w
Making things better
explaining.software·68w·
intent and implication
explaining.software·69w
intent and implication
explaining.software·69w·
structures as paths
explaining.software·70w
structures as paths
explaining.software·70w
decoupling in depth
explaining.software·71w
decoupling in depth
explaining.software·71w

Keyboard Shortcuts

Navigation
Next / previous item
j/k
Open post
oorEnter
Preview post
v
Post Actions
Love post
a
Like post
l
Dislike post
d
Undo reaction
u
Recommendations
Add interest / feed
Enter
Not interested
x
Go to
Home
gh
Interests
gi
Feeds
gf
Likes
gl
History
gy
Changelog
gc
Settings
gs
Browse
gb
Search
/
General
Show this help
?
Submit feedback
!
Close modal / unfocus
Esc

Press ? anytime to show this help