I've been at my current job for 5+ years and it seems like no one in our development dept ever provides comments in any type of code be it in the program code (we are a software company) or in DB objects such as SP's, UDF's, Triggers, ect.  We also have a proprietary scripting that allows our clients to create txt files that contain all teh information needed to create custom reports that can be excuted within our program.  We provide a large number of stock versions of these for clients to use.  We like the whole scripted report concept much better then reports that are hard coded into the program because it's much easier to update and maintain them.  The porblem is there are often no comments in those iether and so clients and those of us in support (where I work) have no idea how many are suppose to work.  I have voiced considerbale concern over this to no avail.  What finally did me in on this and made me give up was when I asked a senior VP about this one day.  I said that while doing so for existing DB objects may be to much to ask, can we at least put in a rule that from this point forward any items added to the schema can not be included in the final product that goes to the client until the developer has added comments to our DDF (Data Dictionary File similiar to an ERD).  His response was no and that asking them to do that was asking too much.  They had more important things to do then worry about documenting everything they do. 

Can anyone share a personal experience that tops that?

Will