Crafting Killer Design Docs: A Practical Guide

2025-08-04

This essay provides a practical guide to writing effective design documents. It likens design docs to mathematical proofs, aiming to convince the reader of a design's optimality. The author stresses clear organization, avoiding the pitfalls of disorganized 'spaghetti design docs'. Key advice includes concise language, one central idea per paragraph, and using appendices for detailed information. Through practice and rigorous editing, the goal is a clear, concise, and persuasive document.

Read more
Development design documents

The Apathy Epidemic: Why Doesn't Anyone Care Anymore?

2025-01-15
The Apathy Epidemic: Why Doesn't Anyone Care Anymore?

This rant explores the pervasive apathy in modern society. From malfunctioning software and poorly designed public infrastructure to everyday inconsiderateness, the author argues that a lack of care is rampant. While not necessarily malicious, this indifference stems from a failure to exert even minimal effort to improve things. The author laments this state of affairs and yearns for a community where caring is the norm, reflecting on their own attempts to inspire positive change and the challenges of living among those who seem unconcerned.

Read more
Misc apathy