Skip to main content

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.

Popular posts from this blog

Making Macbook Air with 128GB SSD usable with Bootcamp

I recently got a new Macbook Air 11" (the 2012 version) and loaded it with goodies like 8GB ram and 2GHz Core i7.  What I DIDN'T upgrade was the internal SSD.  My config came with 128GB SSD and I refused to pay $300+ to upgrade it to 256GB.  Yeah I know, some call me cheap, but SSds cost $75-$150 for 240GB, so adding another 128GB for $300 seemed way too steep for me.  I figured "ok, I'm going to make 128G work!"

Here is the story of how that went...

Installing python 3.4.x on OSX El Capitan

I love "brew" package manager, but sometimes being too progressive breaks things.  I have several python apps that I maintain that get deployed to AWS using Elastic Beanstalk.  AWS eb can deploy with python 2.7 or 3.4.  Any recent 'brew install python3" will get 3.5.1. #annoying

Dell XPS M1330 + Snow Leopard Hackintosh

I have been working with a Dell XPS M1330 laptop for a few years now.  It doesn't quite match up to the newest notebooks in terms of performance, but it certainly still has some life in it.  I had previously installed OSX 10.5.x on it as an experiment, and had moderate success.  I decided to revisit this idea again to install Snow Leopard (OSX 10.6) on the Dell M1330, and keep some notes for those of you brave enough to Hackintosh your own machine...