HOME
Andrew Schwabe's Blog: Rant: Why won't technology professionals document their work ???

Rant: Why won't technology professionals document their work ???

I find this whole concept perplexing!?!?!?  Unfortunately it seems the growing norm that technology professionals are pushed to the limit so often that when they start to bend under pressure, the first thing to go is their "ability to document."

It would seem perfectly respectable if you were doing an integration job with a new firm that doesn't know your technology, you should give them documentation on how to use it right ?  Why is it such a big deal to get documentation like this ???  It seems that the industry is growing to a point where "well, here is something to get you started, you figure out the rest and call me when you get stuck" is the growing norm.

Shame on us for letting it get this bad.  I've done it to, so I don't excuse myself.  But i've also learned from my mistakes too...  Now I document most of what I do, for the sole reason that I work on so many projects that when I need to pick up an old project, I better have some notes on how it works or else I won't remember.

So there is the rant for July.  I am up for suggestion on how technology professionals can make it easier to document our work in languages other intelligent life forms can understand.


Comments