RE: "use-case based documentation"

Subject: RE: "use-case based documentation"
From: "Robart, Kay" <Kay -dot- Robart -at- tea -dot- texas -dot- gov>
To: Julie Stickler <jstickler -at- gmail -dot- com>, Technical Writing <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Tue, 3 Feb 2015 21:48:57 +0000

Well, a use case is sort of task-based, but it shows all the activities that a user wants to perform as well as alternate actions and the behavior of the software. However, use cases are usually produced as part of the requirements process and are written by the business analyst. They aren't very useful to anyone except software designers. I haven't even found them very useful for trying to figure out new software and documented it. Is she asking you to do the business analyst job? Or maybe she doesn't really understand what she's asking?

-----Original Message-----
From: techwr-l-bounces+kay -dot- robart=tea -dot- texas -dot- gov -at- lists -dot- techwr-l -dot- com [mailto:techwr-l-bounces+kay -dot- robart=tea -dot- texas -dot- gov -at- lists -dot- techwr-l -dot- com] On Behalf Of Julie Stickler
Sent: Tuesday, February 03, 2015 11:48 AM
To: Technical Writing
Subject: "use-case based documentation"

One of our Product Managers keeps using the phrase "use-case based documentation" as in, that's something she wants the doc team to provide.
I suspect what she means is task based documentation, but she insists that's not what she means.

However, she has so far failed to provide me with an example of what she wants.

Anyone out there ever provided use-case based documentation? Got any good blogs posts, articles, presentations, or examples so I could get a better idea of what exactly she's asking for?

--
Julie Stickler
http://heratech.wordpress.com/
Blogging about Agile and technical writing ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Doc-To-Help: The Quickest Way to Author and Publish Online Help, Policy & Procedure Guides, eBooks, and more using Microsoft Word | http://bit.ly/doctohelp2015

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as kay -dot- robart -at- tea -dot- texas -dot- gov -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Doc-To-Help: The Quickest Way to Author and Publish Online Help, Policy & Procedure Guides, eBooks, and more using Microsoft Word | http://bit.ly/doctohelp2015

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com


Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


Follow-Ups:

References:
"use-case based documentation": From: Julie Stickler

Previous by Author: RE: Proofreading your own material
Next by Author: Dissertation author needs participation from women technical writers
Previous by Thread: Re: "use-case based documentation"
Next by Thread: Re: "use-case based documentation"


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


Sponsored Ads