• Agreed. But then, "I'm with Jeff on the issue of comments though.  If you *have* to put comments to tell *what* you did, it's either very complex or poorly designed." does not take into account the many cases where we are deling with importing (or mining) data from somebodyelses tables.

    We try to use a good naming convention.  We can use my table documentor to extract the table names, column names, and data types.  The tech writers cut and paste this into the system manual and only have to fill in comments in rare occasions.

    Then I get the joy of having to go get data from SAP, Great Plains, or J. D. Edwards.  Not so bad.  Next I get an assignment to deal with some home grown system.  Now comments every where!

     

    ATBCharles Kincaid