Great idea, Phil. By the way VB .Net has the XML comments too. They show up in the object browser. It forms the minimum set of documentation. But the barest minimum. We had talked about a "librarian" feature that would scanning all our source code and pull this data into some type of searchable repository. We have found that each of us has written the same routine, each in our own way, without knowing that anyone else had already done it.

Andy you are not alone. The thought that descriptive routine names and variable names are enough is pervasive and dangerous. All developers are lazy. (Especially me.) Working for a boss who is a developer is bad. You will share the same bad habits.