Documentation

11 thoughts
last posted Nov. 21, 2015, 3:01 p.m.

4 earlier thoughts

0

When we complain about the lack of comments, what do we really mean?

We might mean that we don't understand what the code is there for.

We might mean that we don't understand what the code is doing, or that it took us a long time to do so.

We might mean that we don't understand why the code is written in this particular way, rather than some ostensibly simpler way we have in our heads.

6 later thoughts