TL;DR
If a system has a clean and obvious design, then it will need less documentation.
設計がきれいで明白なシステムは、必要なドキュメントが少なくなる。裏を返せば、多くのドキュメントを必要とするシステムは、設計に問題がある。
なぜ必要か
不明瞭さは、ドキュメントが不十分なために生じることがある。しかし、その原因は設計上の問題にあることが多い。ドキュメントを足すより先に、システムが明白であるように設計を見直すほうがよい。