Are the Inmates Writing the Documentation?

Subject: Are the Inmates Writing the Documentation?
From: Tom Campbell <klook -at- EUDORAMAIL -dot- COM>
Date: Thu, 15 Apr 1999 14:52:01 -0500

I recently read about a new book by Alan Cooper, The Inmates Are Running the Asylum. I haven't read the book, but judging from the reviews on Amazon.com, Cooper says that present-day software is often coded with little or no up-front design (or with disregard for the design), and with little concern for the user. Too much software, he says, ends up with extra enhancements that make it harder to use, not better.

Now in my experience, these problems are often not the developers' fault, but instead result from scope creep on the part of the customer(s) or management, changing deadlines and priorities, and other factors outside the developers' control. (I recall an interesting letter to the editor in the one of the computer trade mags a couple of months ago protesting an article critical of "cowboy coding." "Please," the developer wrote in his letter, "impose more standards! Make us follow structure! If only we could get management to think that way!")

But my reason for mentioning this book here is not so much to get into that discussion (although I couldn't resist), but to pose the parallel question: How often do we write documentation, design web sites, create online help and EPSSs, etc., without taking the effort to scope and design the product in advance? Aren't we often guilty of the same things of which Cooper accuses developers? (And don't we labor under the same constraints?)

---
Tom Campbell
-------------------------------------------------------
"Keep away from people who try to belittle your ambitions. Small people always do that, but the really great make you feel that you, too, can become great."
--Mark Twain
-------------------------------------------------------




Join 18 million Eudora users by signing up for a free Eudora Web-Mail account at http://www.eudoramail.com

From ??? -at- ??? Sun Jan 00 00:00:00 0000=




Previous by Author: Re: ANNOUNCEMENT: Learn XML Online
Next by Author: Only Human[was Fwd: What if Dr. Seuss wrote technical manuals]
Previous by Thread: Re: DigitalScribes
Next by Thread: Re: Are the Inmates Writing the Documentation?


What this post helpful? Share it with friends and colleagues:


Sponsored Ads