• We have gotten into the habit of formatted documentation in the header with standard stuff at the top describing who, what, when, etc. Then a revision section with numbered revisions, again with who, what, when... Then in the code we will reference additions or changes by the revision number with any additional comments required. You can get a sense of how the code evolved. This can, of course, get messy if there a lot of revisions.