RE: Hackos' minimalism seminar -- some insights

Subject: RE: Hackos' minimalism seminar -- some insights
From: Shea Michael EXT <Michael -dot- Shea -dot- extern -at- icn -dot- siemens -dot- de>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 4 Dec 2002 09:51:26 +0100


Ah, but as you said yourself:

"...the guy who actually has to use the software...is NOT the guy who decided to buy it."

And as you pointed out, this guy isn't consulted when the decision is made to buy the software. So from the standpoint of trying to make a sale, the documentation ought to be directed at the VP making the purchasing decision. (Assuming he or she even looks at the docs. All the VP probably does is sees "docs included" on a Powerpoint slide of product features.) Unfortunately this does not lead to good documentation in the empirical sense.

So our customers are in layers, starting with

1. Your boss (I want my name at the bottom of each page!)
2. Internal reviewers (My second grade teacher says you are misusing the semicolon.)
3. The people presenting the product to others (Can you make our logo flash red and blue?)
4. Potential customers evaluating your product (Get rid of the flashing logo and replace it with ours)
5. The decision maker (He who holds the purse strings)
6. The poor schmuck who actually has to use what you write (I can't find the index!)

Alas the poor user.

--------------------------------------------------------------------
Michael Shea
ROSEMANN & LAURIDSEN GMBH
Am Schlossberg 14, D-82547 Eurasburg, Germany

Phone: +49 8179 9307-19, Fax: +49 8179 9307-12
E-Mail: shea -at- r-l -dot- de, Web: www.r-l.de
--------------------------------------------------------------------


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Check out SnagIt - The Screen Capture Standard!
Download a free 30-day trial from http://www.techsmith.com/rdr/txt/twr
Find out what all the other tech writers, including Dan, already know!

Order RoboHelp X3 in December and receive $100 mail in rebate, FREE WebHelp
Merge Module and the new RoboPDF - add powerful PDF output functionality
to RoboHelp X3. Order online today at http://www.ehelp.com/techwr-l

---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.



Follow-Ups:

Previous by Author: RE: Hackos' minimalism seminar -- some insights
Next by Author: Can we please return to tech writing? RE: OT: Whaddaya Mean, "Th e debate that won't die?"
Previous by Thread: Re: Hackos' minimalism seminar -- some insights
Next by Thread: Re: customer layers


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


Sponsored Ads