Re: Doc Design and Convention ( was TECHWR-L Digest, Vol 48,

Subject: Re: Doc Design and Convention ( was TECHWR-L Digest, Vol 48,
From: "Gene Kim-Eng" <techwr -at- genek -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Sun, 8 Nov 2009 11:56:08 -0800

----- Original Message -----
From: "Chris Despopoulos" <despopoulos_chriss -at- yahoo -dot- com>
> I have never worked in a position where cost was not a factor in deciding how
> many deliverables to create.

Same here, but I don't recall page count ever being the specific deciding factor
(perhaps because I usually encourage my teams to keep it as low as possible in
the first place). In my experience, cost is more commonly expressed as "we
can't afford to hire enough writers to do all that documentation in time to ship
the product." And, of course, the documents always have to be done in time to
ship the product on schedule, which is cost expressed in time rather than in
currency.

> It's been a long time since I've seen a loose cannon wreak havoc on a project
> plan

I've not seen much of that at all, perhaps because most of my experience with
software development has been software designed to control or process data from
a physical product. More commonly, my experience with extraneous features has
resulted from developers' misconceptions about what features are actually needed
to support product objectives due to erroneous initial research, and in the most
extreme cases, misconceptions about what will sell due to erroneous market
research. Sometimes a technical writer who has deep knowledge about the tech
and the needs of intended users can help clear up the first situation, but if
you find yourself in the second, you're probably doomed.

Gene Kim-Eng

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Are you looking for one documentation tool that does it all? Author,
build, test, and publish your Help files with just one easy-to-use tool.
Try the latest Doc-To-Help 2009 v3 risk-free for 30-days at:
http://www.doctohelp.com/

Help and Manual 5: The all-in-one help authoring tool. Full support for
team authoring with multi-user editing - both directly and in combination
with VSS-compatible source control systems. http://www.helpandmanual.com/

---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


References:
Re: Doc Design and Convention ( was TECHWR-L Digest, Vol 48,: From: Chris Despopoulos

Previous by Author: Re: Doc Design and Convention - to address Gene's take on this
Next by Author: Re: RE: tifs at 240 dpi worth redoing?
Previous by Thread: Re: Doc Design and Convention ( was TECHWR-L Digest, Vol 48,
Next by Thread: Re: Doc Design and Convention - to address Gene's take on


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


Sponsored Ads