I think it is also important that all documentation
be signed by its author(s). There is a good chance
that documentation written by the programmer is
wrong ( it might describe a previous version). The
chance that documentation written by someone else
much later is wrong is non-zero.
Documentation of groups of functions may also be
far more useful; Lisp programs tend to be rather shorter
than (say) C programs.
RJF