Subject: Re: UML
From: "Michael West" <mbwest -at- bigpond -dot- net -dot- au>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Wed, 2 Jul 2003 18:22:24 +1000

I'll add my endorsement to the other
posters who point to use-cases
as the most useful feature of the Rational
methodology from the standpoint of
designing and producing end-user assistance
material. You can get more useful
information from a handful of properly
executed use-case diagrams than you can
from hundreds of pages of conventional
system-design chaff -- and the great thing
is that the developers and architects don't
even have to write complete sentences to
generate them. (You may need, though, to
coach them by giving them templates or
examples, and helping the ones who are
having trouble with the concept.)

For example, a set of use-case diagrams
should answer the following questions just
for starters:

1. Who are the users, by category?

2. What specific results will these categories
of users get out of the system, and, for each
result, what data will they put into it to get
those results?

With that information, you can assemble
a basic design for your user-assistance
package (theoretically anyway) before
the first line of code is written. The rest
is filling in the details (buttons and commands)
as the interface is fleshed out.

What an improvement from the old method
of holding four hundred pages of closely-
typed functional specifications up to your
temple at midnight, sprinkling chicken's blood
around the fire, and pleading for Satanic assistance
in answering the question "What the bloody hell is
this software supposed to DO anyway?"

Mike West
Melbourne, Australia

"An active-voice transitive verb always beats
a copula-and-adjective-complement combo."
-- Prof. James Bloom via William Safire


Create professional Help systems that feature interactive tutorials and
demos with all new RoboHelp Studio. More at

Mercer University's online MS Program in Technical Communication Management:
Preparing leaders of tomorrow's technical communication organizations today.
See or write George Hayhoe at hayhoe_g -at- mercer -dot- edu -dot-

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

UML: From: John Posada

Previous by Author: Re: Solution! RE: pushpins
Next by Author: Saying what we mean
Previous by Thread: Re: UML
Next by Thread: RE: UML

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

Sponsored Ads