System Notes
Notes on software systems, business logic, and design decisions.
System Notes is a collection of written artefacts that explain how software systems are reasoned about, designed, and shaped in real environments.
All
System Design
Business & Software
Design & Aesthetics
Execution & Reality
System Design
How UML Diagrams Are Actually Created
Model as you learn, not after you know everything.
System Design
The Real Cost of Bad Database Relationships
When every key has an owner, the system survives.
System Design
Why APIs Fail Long Before They Break
Contracts matter more than code paths.
System Design
State Machines Hidden Inside Every Workflow
Model states before coding flows.
System Design
What Sequence Diagrams Reveal About Teams
Time and trust on the whiteboard.
System Design
The Myth of Scalable Architecture on Day One
Optimize for feedback, not future traffic.