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