Also, you'll want to be really clear on the purpose of the
documentation itself. Is it for a user or a developer? If it's for a
developer, is it so that person can get a sense of where various bits
of processing happen, or so that person can dig right in and find
problem areas without having to walk through hundreds of lines of code?
Also, think about tying your comments to error messages that happen in
the code, and debug statements, so you can make that debugging easier.
And, of course, remember to do the documentation at the same time as
you do your initial coding <G>.
Jeremy
--
Jeremy Wallace
Fund for the City of New York