Re: Software User Guide as Specifications Doc - Anyone tried it?

Subject: Re: Software User Guide as Specifications Doc - Anyone tried it?
From: "Michael West" <mbwest -at- bigpond -dot- net -dot- au>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Thu, 25 Apr 2002 08:01:00 +1000




Kent wrote:

> The premise was centered on project management and the concept that the
> *outline* of the user manual and the software project specification could
be
> essentially the same thing and that both should be created at the outset
of
> the project.


A close parallel to this can be found in the application
of "use case" diagramming in the requirements-definition
phase.

A complete collection of use-case diagrams can serve
not only as the framework for more detailed design
specifications, but also as the high-level outline of the
user-assistance material. All of this con be done quickly,
easily, and fairly painlessly for the developers, since almost
no "writing" is required. A small collection of well-executed
use-case diagrams can contain more useful information than
a thousand garbled pages of traditional specification documents,
and in a fraction of the time.

--
Michael West
Melbourne, Australia



^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Free copy of ARTS PDF Tools when you register for the PDF
Conference by April 30. Leading-Edge Practices for Enterprise
& Government, June 3-5, Bethesda,MD. www.PDFConference.com

Are you using Doc-to-Help or ForeHelp? Switch to RoboHelp for Word for $249
or to RoboHelp Office for only $499. Get the PC Magazine five-star rated
Help authoring tool for less! Go to http://www.ehelp.com/techwr

---
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
http://www.raycomm.com/techwhirl/ for more resources and info.



References:
RE: Software User Guide as Specifications Doc - Anyone tried it?: From: Christensen, Kent

Previous by Author: Re: Directions for tomorrow's techwriting
Next by Author: Re: Word Style Organizer
Previous by Thread: RE: Software User Guide as Specifications Doc - Anyone tried it?
Next by Thread: RE: Book Recommendation: (was Software User Guide as Specifications Doc - Anyone tried it?)


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


Sponsored Ads