RE: TECHWR-L Digest, Vol 36, Issue 6

Subject: RE: TECHWR-L Digest, Vol 36, Issue 6
From: "Legg, Cynthia" <clegg -at- harris -dot- com>
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Mon, 6 Oct 2008 09:59:01 -0400

Hi Sean,

I have never heard of Help and Manual. I build image maps in RoboHelp to
drill down into hardware and/or process flows. I'm assuming you could do
the same thing with Help and Manual?


Message: 1
Date: Sun, 5 Oct 2008 18:13:43 +0800
From: "Sean Diggins" <diggo -at- westnet -dot- com -dot- au>
Subject: Help & Manual, image maps, flowcharts
To: <techwr-l -at- lists -dot- techwr-l -dot- com>
Message-ID: <000901c926d3$0bd197d0$2374c770$ -at- com -dot- au>
Content-Type: text/plain; charset="us-ascii"

Hi all,

I'm an IT Admin at a small business (100 users) with 4 offices spread
300kms. I also have graphics and web design experience, plus many years
writing for newspapers and magazines. The last software manual I did was
pages and built in Pagemaker...nowadays, I'm pretty good with using
Management Systems, WIKIs and so on, but I haven't used a HATT in a long

I've been given the task of rebuilding the company's procedures and
documents. Currently they comprise bundles of PDFs residing in
or uploaded to our copy of Kayako SupportSuite (a good PHP/MySQL
system which includes a rudimentary Knowledgebase, a Troubleshooting
and a Downloads archive). Our business is very reliant on IT. Mobile
workforce, PDAs, proprietary web portals and frequent turnaround of jobs
under high pressure deadlines. It is important that new employees learn
fast. I need to build better induction tools and make it easier to find

SupportSuite is a great tool, but it cant fulfil our needs with respect
user docs. I want to provide a better service to the users and create a
system which is responsive to change and updates. To this end, I've
built a
clean, simple Joomla based intranet to wrap SupportSuite and contain
additional help content. Although Joomla is a good CMS, I'd prefer to
use a
HATT to create the help-related content and then export that content for
in a variety of formats (for example, I can wrap a Help & Manual WebHelp
project into Joomla using an iframe)

We are about to evaluate Help & Manual, as this tool seems priced within
reach and offers easy concurrent user authoring. It also seems fairly
intuitive, a critical aspect given I will be delegating a bunch of the
to clerical staff who I'll have to train beforehand. I also like the
of output formats....and I'm able to grok the xml used during
If our evaluation goes according to plan, we will use Help & Manual as
dominant documentation tool.

In Visio 2007 we have built two complex flowcharts comprising the
workflows in the business. Each workflow comprises a sequence of
events/tasks. Each task is comprised of procedures. I'm wanting to
graphically incorporate the flowcharts into the help structure, in a
which will allow the user to drill down through the flowchart into
individual procedures.

In days gone by, I would have done this with an image map in a static
website. Things have changed a lot since then and I don't know the
quickest/smartest method or tool I should deploy to achieve my desired
outcome. I also don't know if it is a job which suits the capabilities
Help & Manual.

Any tips or suggestions regarding the above would be appreciated.




ComponentOne Doc-To-Help gives you everything you need to author and
publish quality Help, Web, and print content. Perfect for technical
authors, developers, and policy writers. Download a FREE trial.

True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity!

You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -at- lists -dot- techwr-l -dot- com
or visit

To subscribe, send a blank email to techwr-l-join -at- lists -dot- techwr-l -dot- com

Send administrative questions to admin -at- techwr-l -dot- com -dot- Visit for more resources and info.

Previous by Author: "Good enough"
Next by Author: Interesting article and comments on Agile
Previous by Thread: Help & Manual, image maps, flowcharts
Next by Thread: Embedding HTML Help into application

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

Sponsored Ads