[Author Prev][Author Next][Thread Prev][Thread Next]
[Author Index (this month)][Thread Index (this month)][Top of Archive]

Re: Linux users' expectations of online help

Subject: Re: Linux users' expectations of online help
From: "Eric J. Ray" <ejray -at- raycomm -dot- com>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 23 Sep 2003 05:41:59 -0600




Jean Hollis Weber wrote:


In August I wrote to the HATT (help authoring tools and techniques) list asking whether anyone knew of any HAT that runs on Linux. As part of the conversation, one respondent commented:

Unless you want to code your own help module which is
linked to the main application, you are limited to
web-based help and/or man pages when using Linux.

Actually, not quite. See Helen, from www.software7.biz, for
creating JavaHelp.

To expect to get a help application comparable to the
output of Windows HATs is unrealistic at this point,
mainly because Linux caters to a different audience
than Windows does. Most Linux users are perfectly
happy reading man pages or looking at Web-based help
manuals, so the open source movement has not felt the
need to created Window-like HATs.

I think this argument conflates the issues of _users_
and _developers_. That's like saying that Linux users
are happy w/ vi & emacs, so haven't felt the need to create
an IDE. I think that there hasn't been a compelling need for a HAT,
but I see that changing rapidly. We need to separate
the issues of a useful online help system and a useful
online help authoring tool, though. A couple of
the former exist (JavaHelp & Yelp, for example), and
one of the latter (Helen).

This got me thinking about several things.
First and most important, although the audience for open source apps has traditionally been Linux users, and Linux users are traditionally more "geeky" than Windows users, I think this is changing rapidly. Some open source apps (such as OpenOffice.org) are targeting Windows users (and those who purchase Windows-based apps), encouraging them to change to open source and Linux. Some big organisations are already making the change.

True...and Linux is far less geeky than it used to be. (Jean,
I believe that Telestra, your telephone company, is looking at just such a switch.) Many Linux distributions (and customized distributions,
like one from Sun) are quite user friendly, and really not for
the geek community at all.

To me this means that thousands of former Windows users will be bringing their expectations to Linux-based apps. I would assume that at least some of the open-source developers (and those who are developing commercial apps for Linux) will eventually recognise, if they haven't already, that they need to provide task-oriented online help as well as the function-oriented help I often see -- and that they need to provide good indexes, tutorials, and other features that Windows users are more accustomed to.


Agreed. Right now, the tools are pretty limited.


I'd be interested in your perceptions, opinions, and experiences.

Secondly, the quoted message seems to imply that "web-based help" (by which I think is meant "HTML-based help") is not "a help app comparable to the output of Windows HATs."
Certainly that sort of help is created by most Windows-based HATs today, and can contain some advanced features. My original question could be restated as: are there any tools (that run on Linux) available that can produce comparable HTML-based help? (Someone sent some info about a tool for producing tutorials using something called Linux Viewlets, which sound interesting but a bit more ambitious than what I have in mind.)


Not as far as I know. Unfortunately. I'm sure that Docbook can get there, but I haven't reviewed the tools in a few years...it's on
my list of things to do soon, though.




^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

NEED TO PUBLISH YOUR FRAMEMAKER CONTENT ONLINE?
?Mustang? (code name) is a NEW online publishing tool for FrameMaker that
lets you easily single-source content to Web, intranets, and online Help.
The interface is designed for FrameMaker users, so there is little or no
learning curve and no macro language required! See a live demo that
will take your breath away: http://www.ehelp.com/techwr-l3

---
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit
http://www.raycomm.com/techwhirl/ for more resources and info.


Follow-Ups:

References:
Linux users' expectations of online help: From: Jean Hollis Weber

Previous by Author: ADMIN: Update on junk email problems
Next by Author: Re: Linux users' expectations of online help
Previous by Thread: Re: Linux users' expectations of online help
Next by Thread: Re: Linux users' expectations of online help

[Top of Archive] | [Author Index (this month)] | [Thread Index (this month)]

What this post helpful? Share it with friends and colleagues:

Sponsored Ads