<body><script type="text/javascript"> function setAttributeOnload(object, attribute, val) { if(window.addEventListener) { window.addEventListener('load', function(){ object[attribute] = val; }, false); } else { window.attachEvent('onload', function(){ object[attribute] = val; }); } } </script> <div id="navbar-iframe-container"></div> <script type="text/javascript" src="https://apis.google.com/js/plusone.js"></script> <script type="text/javascript"> gapi.load("gapi.iframes:gapi.iframes.style.bubble", function() { if (gapi.iframes && gapi.iframes.getContext) { gapi.iframes.getContext().openChild({ url: 'https://www.blogger.com/navbar.g?targetBlogID\x3d7181760\x26blogName\x3dOffpoint+-+From+Singapore+To+Seattle\x26publishMode\x3dPUBLISH_MODE_BLOGSPOT\x26navbarType\x3dBLUE\x26layoutType\x3dCLASSIC\x26searchRoot\x3dhttp://offpoint.blogspot.com/search\x26blogLocale\x3den_US\x26v\x3d2\x26homepageUrl\x3dhttp://offpoint.blogspot.com/\x26vt\x3d-740194547652384018', where: document.getElementById("navbar-iframe-container"), id: "navbar-iframe" }); } }); </script>
Monday, May 12, 2008
See... don't read..

My team and I have been going through a few rounds of documentation efforts. You might ask why are we doing multiple rounds? I really don't know why, but every single effort get "completed", dumped on a share that no one really knows where, and the documentation expert, typically a vendor, moved on from this project, and we're back to square one after a few months.

One of the things that I've been constantly fighting a battle with my former manager was the fact that a lot of the things that i'm doing is hard to document down. It's also something that he, and other folks, have labeled as "tribal knowledge".

On one hand, i understand the need to have some baseline of knowledge; on the other hand, it is a challenge to provide an almost infinite amount of variables in a system that doesn't necessarily reproduce the same issues every time you try to do so. So what happens is that I'll offer to show people how i think, in the mind set that you train others to fish, and not just hook a single kind of fish.

I often say..."I'll show you... you go document it."; and one one ever took up that offer. I always wonder why folks just do not want to see it to believe it.

There's no way this monkey in Japan could have been reading up documentation before he start serving customers in the restaurant.

Documentation doesn't mean nothing if one doesn't understand!

 
posted by Jonathan at 11:22 PM | Permalink |


0 Comments: