The School for Champions is an educational website that shows you how to achieve your dreams.

School for Champions

SfC Home > Technical Writing >

Explanation of how to use RoboHelp to develop a simple web-base tutorial - Strategies to Succeed in Technical Writing. Also refer to eHelp, ForeHelp, Doc-to-Help, index, java, DHTML, web-based training, WBT, technical documentation, Ron Kurtus, School for Champions. Copyright © Restrictions

Using RoboHelp to Develop a Simple Web-Based Tutorial

by Ron Kurtus (revised 4 May 2003)

RoboHelp is a top application for developing online help. It is also used for developing Web-based help, such as JavaHelp and RoboHelp's WebHelp. Besides being used for online or Web-help, RoboHelp can also be used to develop simple tutorials.

Questions you may have include:

  • Why use RoboHelp instead of other Help applications?
  • How can this program be used to develop a tutorial?
  • What would it look like?

This lesson will answer those questions and help you understand this useful method. There is a mini-quiz near the end of the lesson.

Online help software

The top applications for developing online help are RoboHelp and Doc-to-Help. Both are good and have similar features and capabilities. Each is expensive enough to discourage the casual user. There are also some other less expensive--but not very popular--programs available.

Industry standard

Since RoboHelp is apparently the "industry standard" in the technical documentation arena, this lesson will concern using it, as opposed to one of the others. The principles used are similar in all of the applications, provided they have the same capabilities and features used.

RoboHelp HTML

RoboHelp Office consists of the standard RoboHelp--used for developing WinHelp--and RoboHelp HTML, which allows you to develop HTML Help, JavaHelp and WebHelp.

HTML Help is the format Microsoft is now using in their Office 2000 products. It consists of a compressed file that explodes into a series of HTML help files.

WebHelp is a form of HTML Help provided in RoboHelp HTML, without the compressed file, thus making it suitable for use on the Internet. WebHelp can be delivered as DHTML or Java-based.

JavaHelp is a format that is used in few applications and is completely based on Java.

Using as tutorial

There is a slight difference between online help and a tutorial. Online help is usually logically arranged in a table of contents, but its index feature is most often used to find words and expressions of which the user is unsure.

On the other hand, a tutorial is usually linearly ordered, with no need to jump around. The help system can be effective for simple tutorials. The outline paradigm, with the contents in little books on the side, is handy for the user to locate special areas in the tutorial.

Example of tutorial in RoboHelp HTML

The following is a an example of a tutorial developed in RoboHelp HTML's WebHelp. It goes through the steps required to develop that tutorial.

First try the DHTML version. If your browser does not accept DHTML, try the Java version, which takes somewhat longer to download. Study the example and then complete this lesson.

Developing Tutorial in RoboHelp HTML. (DHTML version)

Developing Tutorial in RoboHelp HTML. (Java version)

This same tutorial is also available as a standard HTML page. Since this is a very short tutorial, the HTML version is actually easier to use. With more complex subjects, the online help versions may be more effective.

Developing Tutorial in RoboHelp HTML (Standard HTML page)

Summary

You can use RoboHelp HTML or other online web-based help development tools to create simple online tutorials. They have the familiar help look to them and are easily navigated.

Answers to Readers' Questions

Write so others may learn

Resources

The following resources provide information on a writing career.

Websites

Macromedia - RoboHelp

WinWriters - Resource for online writers

Society for Technical Communication

Technical Writing Resources

Books on RoboHelp

Essentials of RoboHelp HTML X5 by Kevin A. Siegel ($29.75)

Robohelp for the Web by John Hedtke, et al ($32.97)

RoboHELP 2000 Bible (with CD-ROM) by John Hedtke, Elisabeth Knottingham; ($27.99)

Top-rated books on Technical Writing

Miscellaneous

Mini-quiz to check your understanding

1. What tools can be used to develop web-based online help?

By international treaty, only RoboHelp can be used

Any Windows help application, provided it can compile the help in uncompressed HTML files.

Microsoft Word or a similar word processor

2. What is a major difference between online help and a tutorial?

People use the index in help more than they would in a tutorial

Tutorials always use multimedia, while that is not available in help

People only use help when needed, but that is not true with tutorials

3. Why was the Java applet selected in compiling the WebHelp instead of DHTML?

Java code cannot be compromised by hackers

Concern over browser compatibility

DHTML means "Don't use HTML"

If you got all three correct, you are on your way to becoming a champion in technical writing and e-learning. If you had problems, you had better look over the material again.

What do you think?

Do you have any questions, comments, or opinions on this subject? If so, send an email with your feedback. We will try to get back to you as soon as possible.

Share link

Feel free to establish a link from your website to pages in this site.

Or use our form to send this link to yourself or a friend.

Students and researchers

The Web address of this page is
www.school-for-champions.com/techwriting/webhelp.htm.

Please include it as a reference in your report, document, or thesis.

Where can you go from here?

School for Champions

Technical Writing topics

Using RoboHelp to Develop a Simple Web-Based Tutorial

The School for Champions helps you become the type of person that can be can be called a Champion.