RE: Scoping a DocumentationProject??

Subject: RE: Scoping a DocumentationProject??
From: Tony Markos <ajmarkos -at- yahoo -dot- com>
To: Bonnie Granat <bgranat -at- granatedit -dot- com>, techwr-l -at- lists -dot- techwr-l -dot- com
Date: Wed, 4 Jan 2006 15:49:02 -0800 (PST)

Bonnie Gramat 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

Yahoo! DSL ? Something to write home about.
Just $16.99/mo. or less.


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!

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.

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

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


RE: Scoping a DocumentationProject??: From: Bonnie Granat

Previous by Author: Re: Scoping a DocumentationProject??
Next by Author: RE: Scoping a DocumentationProject??
Previous by Thread: RE: Scoping a DocumentationProject??
Next by Thread: RE: Scoping a DocumentationProject??

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

Sponsored Ads