RE: If you were making a FAQ...

Subject: RE: If you were making a FAQ...
From: "McLauchlan, Kevin" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com>
To: Gene Kim-Eng <techwr -at- genek -dot- com>
Date: Thu, 30 Aug 2012 16:58:15 -0400

Ha-ha. Funny.

The primary documentation for the product in question (one of many) is WebHelp/HTML-5 help totalling over 2000 topics.
Of that, ONE TOPIC is currently a FAQ.

Please be a little careful about that kind of remark, or insert a smiley or something, otherwise, somebody will take it as fact and repeat it, to my employer's detriment.

From: Gene Kim-Eng [mailto:techwr -at- genek -dot- com]
Sent: August-30-12 4:45 PM
To: McLauchlan, Kevin
Cc: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Re: If you were making a FAQ...

I would hope that any company whose primary product document was an FAQ would make it available pre-sale so I can find out that that's all the info I'm going to get in time to shop for an alternate product.

Gene Kim-Eng
On Thu, Aug 30, 2012 at 1:03 PM, McLauchlan, Kevin <Kevin -dot- McLauchlan -at- safenet-inc -dot- com<mailto:Kevin -dot- McLauchlan -at- safenet-inc -dot- com>> wrote:
a) Would you include it in online help (WebHelp) if that was the primary documentation for your product?

b) If yes, then would you make it one big FAQ topic/page, or would you make each Q and A a separate topic/page under a FAQ "book" in the ToC?

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

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 @


If you were making a FAQ...: From: McLauchlan, Kevin
Re: If you were making a FAQ...: From: Gene Kim-Eng

Previous by Author: RE: If you were making a FAQ...
Next by Author: Too many steps, take some out (was RE: If you were making a FAQ...
Previous by Thread: Re: If you were making a FAQ...
Next by Thread: Re: If you were making a FAQ...

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

Sponsored Ads