RE: Marketing view of documentation was Re: dispensing with documentation reviews

Subject: RE: Marketing view of documentation was Re: dispensing with documentation reviews
From: "Beth Agnew" <Beth -dot- Agnew -at- senecac -dot- on -dot- ca>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 2 Jun 2004 14:37:49 -0700

We often must compromise on a project. The question is, to what extent can
we compromise without overstepping our personal values boundary. Rather than
being insulted by the adjective "marketing", I find it focuses on the look
and intent of the documentation, not the quality of its content. There may
indeed be solid marketing reasons for releasing a shallow, incomplete
version of documentation with an early release of a software product. In
that case, I call it "Beta" documentation to indicate it is accompanying
Beta software.

Production values (i.e., making it look professional) serve to assure
potential clients that the company is capable of issuing quality products.
While they might accept beta docs in a binder, a slick and spiffy manual
excerpt raises the perceived value of the product as well, and makes an
effective sales tool.

Note the words "excerpt" and "shallow" above. I would work hard at
convincing the marketing dept that it is better to send a small but complete
section, or high level look at a few tasks, than a manual with gaping holes
in it.

Beth Agnew
Professor, Technical Communication
Seneca College of Applied Arts & Technology
Toronto, ON 416-491-5050 x3133

-----Original Message-----
From: bounce-techwr-l-118812 -at- lists -dot- raycomm -dot- com
[mailto:bounce-techwr-l-118812 -at- lists -dot- raycomm -dot- com]On Behalf Of Ned
Sent: Tuesday, June 01, 2004 2:09 PM
To them, the documentation, whether complete or not, would
fulfill their commitment to providing documentation along with a
test release of the software. If I had not understood the
special requirement for delivery of a good looking but incomplete
doc set PDQ, it would have seemed that Marketing had arrogated a
large portion of the tech writers' professional role, humiliating
us and our best efforts by shipping out a "pig with lipstick."

> The management had a marketing view of documentation ("make it
> look professional")


SEE THE ALL NEW ROBOHELP X5 IN ACTION: RoboHelp X5 is a giant leap forward
in Help authoring technology, featuring Word 2003 support, Content
Management, Multi-Author support, PDF and XML support and much more!

>From a single set of Word documents, create online Help and printed
documentation with ComponentOne Doc-To-Help 7 Professional, a new yearly
subscription service offering free updates and upgrades, support, and more.

You are currently subscribed to techwr-l as:
archiver -at- techwr-l -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.

Marketing view of documentation was Re: dispensing with documentation reviews: From: Ned Bedinger

Previous by Author: Are There Any Robohelp Experts Out There?
Next by Author: RE: Instructions
Previous by Thread: Re: dispensing with documentation reviews
Next by Thread: How to become a techie writer?

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

Sponsored Ads