RE: Ideas for Help 2.0

Subject: RE: Ideas for Help 2.0
From: "McLauchlan, Kevin" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com>
To: "jimmy -at- breck-mckye -dot- com" <jimmy -at- breck-mckye -dot- com>, "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Wed, 11 Jan 2012 14:09:38 -0500

> -----Original Message-----
> From: jimmy -at- breck-mckye -dot- com

> > In the next ten years, I expect improved reporting on how people use
> > help will have far more effect on how we produce that help than any
> > changes on the back end or improvements to authoring or presentation
> > tools.
> On a related note, I think anyone rolling out web help needs to look
> into using web analytics - even free, off-the-shelf solutions like
> Google Analytics. Hard data about what people are reading - and more
> importantly, what people are reading and leaving without needing to
> re-search for more help - is the sort of evidence no stakeholder can
> argue with.

This would be where you create WebHelp that runs on a server
in your own company?

If you are writing WebHelp to accompany a product that you
sell to other companies or to private individuals, then
the options appear to be:

a) it's deployed on the user's own hard drive, so the
analyzer would need to be an executable running on
the user's own system (perhaps hidden in your
application program), and you'd need a way to get
the analysis results back to your own company;

b) it's deployed on a server in the customer's IT
department, and serves WebHelp to people in their
premises or on their WAN/VPN... and you need
the server to phone you and dump the data and/or

Do you have customers who are that lax about their
own security? What industry is that? If we tried
that, it would amount to offering the keys to the
kingdom to our competitors. It would be considered
a "back door".

> >> What I liked about the idea was that the system grew in response to
> >> users' questions. Instead of shipping out a fixed help system that
> is
> >> simply updated periodically, we would provide something that would
> >> grow as people used it.
> >>
> >> Obviously, you would need to keep control of the content and
> >> organization. But your customers' actual needs would define the
> scope
> >> and guarantee that it was helping them. Wow.
> >>
> >> While I appreciate the cautionary replies you've received, there
> >> *are* real innovations out there that you can investigate. I do
> >> thoroughly agree with this idea: The most important source of ideas
> is
> >> your end user.
> Ah, but the devil's in the implementation. How do you get users to
> effectively communicate their needs? How do you make sure that users
> with unusual requests or requests they otherwise can't articulate
> easily
> still get served? And what happens when users aren't aware of the full
> gamut of deliverables? There's the rub...

Indeed. And I've pointed out some barriers to simply
automating the collection of data.


The information contained in this electronic mail transmission
may be privileged and confidential, and therefore, protected
from disclosure. If you have received this communication in
error, please notify us immediately by replying to this
message and deleting it from your computer without copying
or disclosing it.


Create and publish documentation through multiple channels with Doc-To-Help.
Choose your authoring formats and get any output you may need. Try
Doc-To-Help, now with MS SharePoint integration, free for 30-days.

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-leave -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.

Looking for articles on Technical Communications? Head over to our online magazine at

Looking for the archived Techwr-l email discussions? Search our public email archives @


Re: Ideas for Help 2.0: From: Nancy Allison
Re: Ideas for Help 2.0: From: jimmy

Previous by Author: RE: future tense vs present tense
Next by Author: RE: Ideas for Help 2.0
Previous by Thread: RE: Ideas for Help 2.0
Next by Thread: RE: Ideas for Help 2.0

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

Sponsored Ads