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.
Question: Should I close my Wells Fargo bank account?
Answer:
Not necessarily. That’s like being a deer covered in ticks and you think removing ONE tick is going to make you healthy.
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.
Question: Isn’t there a way to set up my docs so that each piece of information appears in only one place?
Answer:
Theoretically yes, if you don’t mind a cure that is worse than the disease.
Art Before Science 