Re: Scoping a DocumentationProject??
Bonnie Granat stated:--
They [developers] create software or software plans,
you document [using their software or plan as your
input]. You cannot "scope" out a documentation project
for something that doesn't exist yet unless you talk
to the developers or look at firm plans for the
Tony Markos responds:
If the TW is working pre-development on, for example,
a requirements spec, it has been my experience that
most often the TW is not simply given a scope
statement with the required degree of rigor. Frankly
Bonnie, I usually get a disjointed mess called a plan
of some sort and I am charged with creating a
smooth-flowing user-friendly requirement doc.
To create such a doc in such situations, the TW has to
draw the scope out of the developers. And, for
larger-scale systems, a fairly rigorous and formal
process seems to be required. It is this process of
proding the developers (and/or SMEs) that I am asking
Professor, Technical Communication
Seneca College of Applied Arts & Technology
Toronto, ON 416.491.5050 x3133
Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today! http://www.webworks.com/techwr-l
Doc-To-Help 2005 now has RoboHelp Converter and HTML Source: Author content and configure Help in MS Word or any HTML editor. No proprietary editor! *August release. http://www.componentone.com/TECHWRL/DocToHelp2005
You are currently subscribed to TECHWR-L as archive -at- infoinfocus -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%40infoinfocus.com
To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com
Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.
RE: Scoping a DocumentationProject??: From: Tony Markos
Previous by Author:
Re: Items in a Series and Comma Use
Next by Author: Re: Scoping a DocumentationProject??
Previous by Thread: RE: Scoping a DocumentationProject??
Next by Thread: Re: Scoping a DocumentationProject??
Search our Technical Writing Archives & Magazine