I cracked the code
What a relief it is to figure out the inner workings of a black box! Without proper documentation or instruction manual, I had to rely on trial and error and logic.
Some years ago, I got landed with a task that no one else wanted to attempt. It was an archaic in-house software that had evolved over time but still mission critical for the business. I painstakingly went through each line of code trying to determine its purpose and how it fitted in the overall scheme of things.
After much testing, I finally pieced together the jigsaw puzzle. The resulting documentation was over a hundred pages long. Needless to say, it remained a black box for everyone else. Who would want to read the documentation I wrote?
I learned over time to build simple models that people can understand. Simple to build and simple to use. Transparent. Welcoming. A model, by definition, should be a simplified version of reality, not a more complicated one. However, model builders often forget about keeping it simple but pride themselves in building complex models that only they have the stamina and the interest to understand and use.
9 July 2004 Friday