How useful are tooltips in online help?  Clip to Evernote

Recently, a colleague sent me a document detailing the DITA message specialization. The document is an HTML Help file, and I noticed that many of the links in the file (which described certain DITA elements) had tooltips which appeared when I held the mouse pointer over them.

tooltip.pngI viewed the source of one of the topics in the file, and discovered that the author of the document had added the HTML title attribute to the links, along with a description of each DITA element. It was a simple and effective solution, one which didn’t require any scripting. Overall, it was a nice touch.

Then, I began to wonder how useful something like this actually is.

Continue reading

A few thoughts on FOSS help authoring tools  Clip to Evernote

Anyone who knows me will tell you that I’m an avid user and staunch supporter of free and Open Source software (FOSS). I could list all of the apps that I use, but that would be a lengthy blog post in itself.

There’s a lot of great FOSS software out there. But one area in which it’s lacking is professional-level help authoring tools. In 2005, Linux.com published an article titled “FOSS help authoring tools falter“. And not much seems to have changed in the intervening years.

Continue reading