Lightweight Methodologies

3-little-pigs500

Question: Is anyone using structured tools such as FrameMaker anymore? What is this “lightweight” stuff I keep hearing about?

Answer:
The eternal conflict between permanence and expediency is another effect of the speeded-up world we live in, where things that used to take hours or days can now be done on your smart phone in 5 seconds or less. Lightweight is great as long as you have a way to tell when it’s no longer enough, and a plan for what to do when that critical mass is reached.

Continue reading

First Drafts

jungle-of-lost-info500

Question: How polished-looking does my first draft need to be?

Answer:
This is an important question, now that documentation has not only moved online, but has migrated into Wiki-like systems where you can have miles of empty placeholder topics, maybe 10 of which are actually populated – and it’s all in your live system because it’s always a work in progress. There’s no way a user can tell from the listings which topics actually have data in them.

Continue reading

Time Machine

time-machine500

Question: I need a time machine to go backwards 2 days in order to reflect last-minute decisions.

Answer:
People just want to wait until the past possible second to commit to a decision, but then, they want everything else to fall into place instantaneously to reflect it. The result is that vanishing slice of time that you’ll have to reflect all these decisions in the documentation.

Continue reading

Smart Phone Nightmares

smart-phone-nightmare500

Question: For the past several weeks, I’ve been having nightmares about my phone acting crazy. Should I see a shrink or an exorcist?

Answer:
I would try to enjoy these nightmares for their colorful and bizarre content, and not worry too much. These are anxiety dreams, which are more typically expressed as “examination dreams” where you’re suddenly back in high school taking that old trigonometry exam all over again – while naked. Anxiety is normal, and is your brain’s way of working things out.

Continue reading

Project Schedules

project-taming500

Question:
Our new project scheduling tool allows exactly one day to write and translate all the manuals for a major new system. Are they nuts? What do I do?

Answer:
Project managers maintain complicated Gantt charts with dependencies in order to foster the illusion that projects follow an orderly process. Projects are more like wild beasts tamed by chairs, and even that only goes so far.

Continue reading

Land of Excuses

land-of-excuses500

Question: I have this friend who keeps breaking dates with me at the last possible second. Each time there’s a plausible reason, but I’m beginning to wonder what’s really going on.

Answer:
Welcome to the Land of Excuses, where good intentions count as reality. The old saying “The road to hell is paved with good intentions” can be appended with “roofed with excuses, and wallpapered over with rationalizations.”

Continue reading