How to Write an Effective Software Design Document

Michael Lynch’s test for what belongs in a design doc: what’s the penalty for being wrong? Worth writing for multi-person, long-lived or ambiguous projects; a language choice earns discussion, pagination style doesn’t. He lists 23 possible sections; few projects need them all.