Re: need advice - writing wiki Help for web app

[Di <dicorrie -at- gmail -dot- com>]

Wizard walk throughs sound like a thing to be investigated, to be sure. What
tools are you using for that?

Thanks,

Di


On Tue, Feb 1, 2011 at 9:42 AM, Gene Kim-Eng <techwr -at- genek -dot- com> wrote:

> We're writing more and more help that goes the other way - more
> screens and less prose.  Wizards "walk" the user through common tasks
> by means of sequenced popups that appear over images of dialogs
> pointing to buttons and data entry fields.  The popups that name the
> UI elements and provide procedure steps are text strings that are
> localized with the product, and the screenshots have their text labels
> removed or dithered so the same graphics can be used for all
> languages.  The traditional figure with numbered callouts and a table
> of descriptions is now used only for printed docs or pdf versions of
> the help.
>
> Gene Kim-Eng
>
>
>
> On Mon, Jan 31, 2011 at 11:57 AM, Di <dicorrie -at- gmail -dot- com> wrote:
> > i tend to translate this one thus:
> > . dont use screen shots to illustrate procedures (why would you when you
> > have got the app alongside)
> > . in other contexts a screenshot or part of a screenshot, perhaps with
> > annotation or two, will illustrate the general principle of using raphics
> in
> > documents - look nice and be a 'picture tells a thousand words'.
>  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
> Create and publish documentation through multiple channels with
> Doc-To-Help.
> Choose your authoring formats and get any output you may need. Try
> Doc-To-Help, now with MS SharePoint integration, free for 30-days.
> http://www.doctohelp.com
>
> ---
> You are currently subscribed to TECHWR-L as dicorrie -at- gmail -dot- com -dot- 
>
> To unsubscribe send a blank email to
> techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
> or visit
> http://lists.techwr-l.com/mailman/options/techwr-l/dicorrie%40gmail.com
>
>
> To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com
>
> Send administrative questions to admin -at- techwr-l -dot- com -dot-  Visit
> http://www.techwr-l.com/ for more resources and info.
>
> Please move off-topic discussions to the Chat list, at:
> http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat
>
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Create and publish documentation through multiple channels with Doc-To-Help. 
Choose your authoring formats and get any output you may need. Try 
Doc-To-Help, now with MS SharePoint integration, free for 30-days. 
http://www.doctohelp.com

---
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-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

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

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat