TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Subject:Re: web apps - how to embed help ? From:Craig Haiss <craighaiss -at- yahoo -dot- com> To:monique -dot- semp -at- earthlink -dot- net, techwr-l -at- lists -dot- techwr-l -dot- com Date:Thu, 2 Sep 2010 08:53:20 -0700 (PDT)
Hi, Monique. You could try using the HTML-based outputs from Flare or RoboHelp. Both have APIs that programmers can use to link help into the GUI.
You could also just use straight HTML topics, and the programmers can manually build calls to show the right topic. You'll just have to provide some sort of map file that tells the programmer which help topic should show up for each interface object. The JavaScript OnMouseOver event can be used to display topics when you hover over an interface element.
However, the first option (Flare or RoboHelp) is probably the easiest, since help topics in these tools are available to guide you and the programmers through the process of linking your help to the interface.
> From: Monique Semp <monique -dot- semp -at- earthlink -dot- net>
> Subject: web apps - how to embed help ?
> To: "techwr-l" <techwr-l -at- lists -dot- techwr-l -dot- com>
> Date: Wednesday, September 1, 2010, 7:36 PM
> So, what technologies or tools are
> out there? My client is finally ditching the old
> Word-to-PDF that was hyperlinked from the Web app, and wants
> context-sensitive help; yay! They want to investigate
> the possibilities. Other divisions in their company
> use Confluence; they've played around with TiddlyWiki, which
> you can apparently link from any given app page to a given
> wiki page. But what other options are there?
>
> But I was thinking that there must be some tool that
> provides those helpful popups when you hover over a question
> mark; and I'm sure there are plenty of other things.
>
> Looking forward to ideas,
> -Monique
Gain access to everything you need to create and publish information
through multiple channels. Your choice of authoring (and import)
formats with virtually any output. Try Doc-To-Help free for 30-days. http://www.doctohelp.com/
LavaCon 2010 in San Diego Sept 29 - Oct 2 is now open for registration.
Use referral code TECHWR-L for $50 off conference tuition!
See program at: http://lavacon.org/
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-