Re: "use-case based documentation"

Subject: Re: "use-case based documentation"
From: Scott Turner <quills -at- airmail -dot- net>
To: "Robart, Kay" <Kay -dot- Robart -at- tea -dot- texas -dot- gov>
Date: Tue, 3 Feb 2015 16:14:28 -0600

>From the OP, it really sounds as though the products after is using buzz words, and that she dimly understands the meaning behind them.

Scott T.


> On Feb 3, 2015, at 15:48, Robart, Kay <Kay -dot- Robart -at- tea -dot- texas -dot- gov> wrote:
>
> 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 quills -at- airmail -dot- net -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
RE: "use-case based documentation": From: Robart, Kay

Previous by Author: Re: Markdown to PDF
Next by Author: Re: "use-case based documentation"
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