YAMAMOTO Takashi <yamt@mwd.biglobe.ne.jp> writes:
>> Sure, but there will be times where people want to make changes and
>> fixes to that code itself.
>
> in that case, what's a problem with just reading the code?

With enough effort, code is always, in theory, self
documenting. However, it is frequently much easier to gain an
understanding of a piece of code and what it aims to do if there is a
document that provides a general explanation of the code's structure,
design, and major data structures and algorithms.

It think it is usually valuable to have more documentation about how
code is structured. The major question is, where should such
documentation reside?

Perry