Notes
Technical writing and engineering essays.
Engineering
- Why I Chose Astro Over Next.js for Content Sites A framework decision record comparing Astro and Next.js for content-heavy sites, with performance measurements and architectural trade-offs.
- Choosing PostgreSQL Over MongoDB for a Document-Heavy Application A decision record on why a document-oriented application moved from MongoDB to PostgreSQL, with performance measurements and maintenance observations.
Architecture
- Folder Structure as Documentation Why organizing files by domain rather than type improves codebase discoverability and reduces onboarding friction.
- API Design Consistency Through Explicit Contracts How enforcing API contracts at the type level reduced integration bugs and improved frontend-backend collaboration.
Performance
No notes in this category yet.
AI
Systems
No notes in this category yet.
Design
No notes in this category yet.
Observations
No notes in this category yet.
Decision Log
- Why Motion Only Communicates State A decision log establishing the animation policy: motion exists only to communicate state changes, never for entertainment or decoration.
- Why Gradients Were Removed A decision log on removing all gradients from the design system and accepting the visual consequence of that choice.