TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:RE: use cases - what are they good for From:"Downing, David" <DavidDowning -at- Users -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Wed, 12 Jan 2005 10:05:04 -0500
Actually, we've begun including use cases in our project documentation
as well. I'm hoping the use cases will be useful in writing
user-documentation, but I still have to get the hang of using the use
cases properly.
-----Original Message-----
From: Neumann, Eileen [mailto:ENeuman -at- franklintempleton -dot- ca]
Sent: Tuesday, January 11, 2005 10:53 AM
Subject: use cases - what are they good for
Hi Tech Whirl,
Does anyone use 'use cases' to develop / write procedures? I've been
investigating this topic, and it seems that use cases are very good for
explaining how various systems and / or people interact. However, I'm
thinking that they are not going to be of use to my type of
documentation. I am writing a user guide for processors in a financial
institution - basically giving them instructions on how to perform
various tasks on a large database. The goal is having easy to understand
task based instructions. The procedure is written from a processor's
point of view.
The business recovery division of my company swears by use cases. The
material they produce however is not at all user friendly however, as
it's written at such a high level. They do have different goals and a
different audience than I do.
Use cases are appealing to me in that they give me a standard method of
analyzing procedures, instead of just starting to write and hoping for
the best. However, the results that I have seen aren't at all what we
require for procedures.
I'd like to know anyone's experience with use cases. Are they perhaps
suited to IT only?
Thanks for your help,
Eileen Neumann
Franklin Templeton Investments
Notice: All email and instant messages (including attachments) sent to
or from Franklin Templeton Investments (FTI) personnel may be retained,
monitored and/or reviewed by FTI and its agents, or authorized law
enforcement personnel, without further notice or consent.
_____________________________________________________________________________________
Attention:
The information contained in this message and or attachments is intended
only for the person or entity to which it is addressed and may contain
confidential and/or privileged material. Any review, retransmission,
dissemination or other use of, or taking of any action in reliance upon,
this information by persons or entities other than the intended recipient
is prohibited. If you received this in error, please contact the sender and
delete the material from any system and destroy any copies.
_____________________________________________________________________________________
This email message has been scanned for Viruses and Content and cleared
by NetIQ MailMarshal
_____________________________________________________________________________________
WEBWORKS FINALDRAFT - EDIT AND REVIEW, REDEFINED
Accelerate the document lifecycle with full online discussions and unique feedback-management capabilities. Unlimited, efficient reviews for Word
and FrameMaker authors. Live, online demo: http://www.webworks.com/techwr-l
Technical Communication Certificate online - Malaspina-University College, Canada. Online training in technical writing, software (FrameMaker, RoboHelp, Dreamweaver, Acrobat), document & web design, writing manuals, job search. www.pr.mala.bc.ca/tech_comm.htm for details.
---
You are currently subscribed to techwr-l as:
archiver -at- techwr-l -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -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.