設計文書のうまい書き方

設計文書のうまい書き方を読みました。設計文書 (基本設計書や詳細設計書) は、どの程度の粒度で書くか、人によってばらばらなのが困ります。*1

個人的には、ソースコードがドキュメントという考え方が好きで、ユニットテストとリファクタリングを率先して行っています。設計書は、一目見てわかる程度の非常に大きな枠組みだけを残すようにしています。

*1:絶対の解というのが存在しないからなのでしょうが……