Хороший design doc экономит годы разработки

How to Write an Effective Software Design Document

Автор, писавший design docs в Google, Microsoft и собственных компаниях, объясняет, как создать эффективный документ проектирования. Он разбирает, когда стоит его писать, сколько усилий вкладывать и что включать: от целей и сценариев до диаграмм и глоссария. Ключевой принцип — оценивать цену ошибки: если решение легко исправить, не тратьте время на его детальное описание.