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

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

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...

Getting Started with OpenVAS on CentOS - an open source vulnerability scanner

The Open Vulnerability Assessment System (OpenVAS) is a framework of several services and tools offering a comprehensive and powerful vulnerability scanning and vulnerability management solution. (Taken from the OpenVAS website, which is at )

This blog entry will introduce OpenVAS version 3.1, walk through installation on CentOS and is intended as a "getting started" guide. I'll also do a guide for installing on Ubuntu later.