I don't think there is anything wrong with
too documentation, if anything... there is
something wrong with too
less documentation (I know, bad grammer.. but you get the
gist). Documentation doesn't slow code down - but it does make it understandable to those
who must follow in your footsteps later to maintain it. Even if you maintain that code,
months later you may forget exactly what you're trying to do in a certain function or
whatnot - and documenation helps trigger the memory or explain it completely. Although
many programmers detest documentation or documenting their own code - it's something
that they're rather thankful when inheriting a project. It doesn't take too much effort
and it saves time down the road... here are a few other nodes that have talked about documentation. Check out
use documentation; and
Danger, danger Will Robinson (documenting code).