Re: need advice - writing wiki Help for web app

[kafkascampi <kafkascampi -at- gmail -dot- com>]

""Don't use screen shots" was never a hard and fast rule. 6 out of 7 tech
writers agree (+/-2)."

I'll weigh in to say that I've avoided screenshots in help, unless they are
absolutely necessary/demonstrate a point far better than pure text. I reuse
DITA XML content between my help system and manuals, with conditional
formatting on the images that exclude them from the HTML output. In a help
system with several hundred topics, I have fewer than 10 images.

I have just started putting Flash video on some help topics as well, to help
users who prefer to learn that way.

Chris Vickery

On Mon, Jan 31, 2011 at 6:07 PM, Gene Kim-Eng <techwr -at- genek -dot- com> wrote:

> XML authoring is done in Vasont.  Help viewer building is in a
> company-proprietary tool produced in-house.
>
> Gene Kim-Eng
>
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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