Re: A "new understanding" about tech pubs

Subject: Re: A "new understanding" about tech pubs
From: "Mike O." <obie1121 -at- yahoo -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Sat, 7 Dec 2002 21:37:17 -0800 (PST)

Andrew writing about Company A:
> The writers at this company are pretty savvy and it shows.
> They clearly have command over their technology. They
> understand the benefits, value, and use of their product.
> As such, I have a lot more faith in this company and as such,
> I am going to sign a reseller agreement with them.

So clearly this company has the right attitude about the
importance of technical writing. They must have invested the
time and $$ into integrating their writers into the development
process and providing them with the resources to create topnotch
docs. Obviously they treated their tech writers as a crucial
part of the development team and now they are reaping the

You can bet these writers got answers PDQ from their development
team when they needed answers, and they didn't have to sponsor a
pizza party and wash the developer's cars to get the

Andrew writing about Company B:
> The docs were the standard tech doc crap: pages
> and pages of instructions with virtually no context or
> explanation. The writers took 10 pages to document every
> menu item. The writers clearly did not have command over
> the topic and as such, I am left to believe that the
> company doesn't really have their act together. I will
> not be signing a reseller agreement with that firm.

I'm guessing this company didn't understand the importance of
docs; they considered it a low-level support item so they left
it until the last minute and then went bottom-fishing for
somebody with "1-2 years experience" to do their docs.

In the end, every company gets the documentation they deserve.

Mike O.

Do you Yahoo!?
Yahoo! Mail Plus - Powerful. Affordable. Sign up now.

Check out SnagIt - The Screen Capture Standard!
Download a free 30-day trial from
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

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 for more resources and info.

Previous by Author: Re: All hail John Posada, the new TECHWHIRL King!!
Next by Author: Re: Bouncing Reality Checks
Previous by Thread: RE: A "new understanding" about tech pubs
Next by Thread: Re: HELP! xml-to-mif conversion

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

Sponsored Ads