Re: Software documentation that uses effective visual metaphors?

Subject: Re: Software documentation that uses effective visual metaphors?
From: Lois Patterson <loisrpatterson -at- gmail -dot- com>
To: techwr-l <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 6 Aug 2014 10:39:07 -0700

Of course simply explaining the product never, ever occurred to me :).

The reason I am asking is that we are documenting highly complex software
that is not intuitively obvious, at least at first. A team member has
developed some graphics that represent a visual metaphor to explain some of
the inner workings, and I was trying to find examples of other software
packages that have done the same.

Lois




On Wed, Aug 6, 2014 at 7:20 AM, Lynne Wright <Lynne -dot- Wright -at- tiburoninc -dot- com>
wrote:

>
> By "visual" metaphor, do you mean a graphic? Or a written metaphor that
> evokes a visual image?
>
> And why would you use a metaphor to describe what a product does... why
> wouldn't you just ... um... explain what it does?
>
>
>
> -----Original Message-----
> From: techwr-l-bounces+lynne -dot- wright=tiburoninc -dot- com -at- lists -dot- techwr-l -dot- com
> [mailto:techwr-l-bounces+lynne -dot- wright=tiburoninc -dot- com -at- lists -dot- techwr-l -dot- com]
> On Behalf Of Lois Patterson
> Sent: August-05-14 8:16 PM
> To: techwr-l
> Subject: Software documentation that uses effective visual metaphors?
>
> Does anyone know of software documentation that uses effective visual
> metaphors to describe the processes that the software performs? Clearly,
> lots of software documentation is visually attractive. But I am looking
> specifically for visual metaphors and analogies.
>
>
> Lois
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
> Read about how Georgia System Operation Corporation improved teamwork,
> communication, and efficiency using Doc-To-Help | http://bit.ly/1lRPd2l
>
> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> You are currently subscribed to TECHWR-L as Lynne -dot- Wright -at- tiburoninc -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
>

^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Read about how Georgia System Operation Corporation improved teamwork, communication, and efficiency using Doc-To-Help | http://bit.ly/1lRPd2l

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

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:
Software documentation that uses effective visual metaphors?: From: Lois Patterson
RE: Software documentation that uses effective visual metaphors?: From: Lynne Wright

Previous by Author: Software documentation that uses effective visual metaphors?
Next by Author: Re: Software documentation that uses effective visual metaphors?
Previous by Thread: RE: Software documentation that uses effective visual metaphors?
Next by Thread: RE: Software documentation that uses effective visual metaphors?


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


Sponsored Ads