GUEST BLOG: Setting the Help Hooks: Context Sensitive Help Using RoboHelp

Thursday, November 7 2013 @ 12:08 PM, By Maxwell Hoffmann

02 hookdsHelp maven, Neil Perlin, is delivering a 3-part webinar series on Advanced RoboHelp. This is the first of 3 guest blogs by Neil that summarize his guest webinars.

This blog covers highlights of “Setting the Help Hooks: Context Sensitive Help Using RoboHelp.” If you click on the webinar title in the previous sentence, you will jump to an “event registration” page that will allow you to view the webinar after you enter your Adobe.com account credentials.

FYI — there are often questions about how to implement CSH (Context Sensitive Help.) The webinar summarized in this blog is one of the best references we have seen on this topic; we strongly encourage you to view it.

_________________________________________________

Welcome to the first of three blog posts dealing with questions that I often hear about Adobe RoboHelp, typically “Can RoboHelp do such and such?” In this post, I’ll look at context sensitive help – what it is and whether and how RoboHelp can create it.

 

Basic Definition

 

Context sensitive help (“CSH”) is help that’s sensitive to the context in which it’s invoked – e.g. the help system in an application knows what users are doing when they ask for help and displays only the help that’s appropriate. For example, if you’re on the Print dialog box and click the Help button, you’ll see the help specifically for the Print dialog box; you won’t have the entire help system thrown at you and have to find the desired topic on your own. As simple as that.

 

CSH “Design”

 

“Design” refers to the level at which CSH is provided. It’s usually large scale, such as for screens or dialog boxes, or small scale, such as for screen objects like a field. How do you choose?

The small scale design seems to make sense because of its granularity. If each field has its own individual help, there’s no wading through irrelevant material like you’d find if there was one help topic for a dialog box that had multiple fields.

01 early CSHHowever, the small scale option suffers from the conflicting problems of completeness versus silliness. In other words, completeness would demand having a help topic for every field on a dialog box even if some of those fields are so obvious that any help topic for them would be silly – e.g. “Type your name here” (in a Name field). However, fields that seem obvious are not. Consider a Zip Code field on a User Information dialog box. We don’t need help about the format of a zip code. But what if the software was being used in Canada, where they use Postal Codes. The Zip code format may be unfamiliar and require help.

The large scale model is less granular than the small scale model but it eliminates many problems of the small scale model. It creates one CSH topic per screen or dialog box, typically accessed by clicking a Help button, so there’s less clutter on the screen. There’s also less work for the programmers. And the large scale model translates neatly onto the web.

My recommendation to most of my clients is to use the large scale model. But I advise them to see what their competitors are doing with CSH, with the caveat that just because their competitors may be doing something doesn’t make it right. (Think of your mother saying “just because all your little friends are creating field level CSH doesn’t make it right”.)

 

How to Create CSH for a RoboHelp Project, Using RoboHelp

 

Can RoboHelp create CSH? Absolutely. It’s been able to do so almost since it appeared in 1991. Why the odd wording of the section title? Because today, you can create CSH for a RoboHelp project by using any proprietary method that your programmers come up with or by using either of two methods supported within the RoboHelp interface. The proprietary methods are so different as to be impossible to sum up in one post. Talk to your programmers and document the process.

There are two approaches through the interface – the map file/alias file model and the link model. Both basically do the same thing – open a help topic associated with a specific dialog box or screen and open the navigation panes – the toolbar and the ToC, Index, and Search tabs – around that topic. What makes the two models different is their mechanics, who does what work, and whether the navigation panes open automatically or manually. Watch the recording of the webinar for an explanation of how the two models work. Here, I’ll just sum them up.

 

Map/Alias File:

  • Navigation panes open automatically.
  • The use of aliases in the coding provides more programmatic flexibility than the link model.
  • But the use of aliases in the coding means more work for the help authors, who have to create the map and alias files, and the programmers, who have to create and embed map #s in the application screens.

Link:

  • Navigation panes open when the user clicks on a “Show me the navigation panes” link.
  • The hard-coded paths from the Help buttons in the dialog boxes to the appropriate HTM files means less programmatic flexibility than the map/alias file model.
  • But the help authors’ ability to turn on the link feature with a single mouse click in RoboHelp means that the programmers effectively do all the work.

 

Summary

Creating CSH is one of the most tedious tasks in help authoring, and it must be done correctly. If it’s not, the result can be a Help button that doesn’t work or, worse, opens the wrong help. RoboHelp provides various options for CSH creation depending on your technical needs and development resources and go far to make the work less tedious.

 

About our Guest Blogger:

Neil Perlin is an independent technical communicator and online help trainer and consultant. He’s used, trained, and consulted on RoboHelp since 1991 and is Adobe-certified in RoboHelp. He is the organizer of the Beyond the Bleeding Edge stem at the annual STC summit and a columnist for STC Intercom. — E: nperlin@nperlin.cnc.net  –  W: www.hyperword.com  –  Twitter: NeilEric

 

Have your own hands-on with RoboHelp 10 and decide how you can use it

After watching these videos, you may wish to have your own hands-on with RoboHelp. The quickest way to do this is to have use a trial copy of Tech Comm Suite 4, which includes FrameMaker 11 and RoboHelp 10. You can try your own hands-on by clicking here. This link also includes a link to a Quick Start Guide for RoboHelp.

COMMENTS

  • Categories

  • Archives

  • Authors

  • Useful Links

  • Recent Comments

    • Don Bridges: I expect privacy concerns will tamper IoT for our homes and consumers, but for business it will usher a...
    • Lois Patterson: I’m always happy to see math support, although I’m not currently using FrameMaker. I have...
    • Olga: I know it’s a really old post but I was unable to find any information online. I need to number the...
    • click: yes. http://wwwimages.adobe.com/www .adobe.com/content/dam/Adobe/e n/volume-licensing/pdfs/avl...
    • tiggyboo: I know the specs say IE 9 or greater is required – but was Server 12 developed specifically for IE or...