views:

424

answers:

1

I'm building a desktop application in Flex/AIR, and one of the current items on my TODO list is to develop a help system.

Throughout the GUI, there are little (?) buttons. When the user clicks one of those buttons, a HelpPanel appears, displaying some relevant information from the docs.

Simple enough.

But I'd really like to build a full-fledged help system, just like the ones normally deployed in desktop apps: a hierarchical table of contents, the ability to search for keywords, hyperlinking between help topics, etc.

Also, since my app will provide an API for plugin authors, I'd like to also provide hooks for third-party plugins to integrate their own documentation in with the core help system.

With my app, the user may not always be online, so all of the help data must be available locally (though it'd be very cool if new help content could be synchronized periodically from a server).

Building that kind of help system from scratch would be relatively straightforward, but it would also take a lot of time away from actually developing the core features of my application, so I'd rather use an off-the-shelf solution.

I've done a bit of googling, but can't find anything that fits the bill.

Any suggestions?

+1  A: 

You might consider using the AIR html control to display html help files bound to links in your app, and built using any number of available tools for constructing HTML help screens.

If you design it using a conventional web server directory and file structure, there are plenty of tools for maintaining synchronized files.


This link references an AIR-based help system, and a possible interface to RoboHelp.

Here is a link to the RoboHelp "Packager".

Another page of possible interest.

le dorfier
This is pretty much what I've been thinking. But it falls squarely in the "build it myself" category, since I'd have to develop my own code for assembling the table of context, providing fulltext search (and therefore pre-indexing the help content), hyperlinking between help topics, etc., etc.
benjismith
I'm not sure that's true. Almost any help-building software these days will export to HTML files, and compiled help files can be reverse-compiled, can't they?
le dorfier
See the links I added to my answer.
le dorfier