Re: documentation going away

Subject: Re: documentation going away
From: Phil Snow Leopard <philstokes03 -at- googlemail -dot- com>
To: John Allred <jack -at- allrednet -dot- com>
Date: Mon, 16 Jan 2012 21:53:07 +0700

I agree in the sense that if you want to know a product comprehensively, you can't beat a good manual. However, most users don't want that, they only want what was in the past tacked on in a page or three (if lucky) at the end labelled 'Troubleshooting'. Inch-thick manuals are really for those of us who provide help on online community forums, rather than for the majority of those who seek it, IMHO.


On 16 Jan 2012, at 21:46, John Allred wrote:

> The rationale for shifting support to user communities is obvious, from a cost perspective. But, from a user perspective, I question whether we should acquiesce in this trend to offload responsibility for support. Whether printed, or in a PDF or eBook format, company-written documentation has the benefit of being organized and authentic. Forums are not. Google is not. Searching for help on specific issues can be like searching for the proverbial needle in the haystack. I used to have a one-inch-thick Excel manual on my desk that laid it out from A to Z. Besides being organized, it was also thorough. Now, I lose lots of time searching for help on Excel functions.
> I think we've lost something extremely valuable.
> John
> On 1/16/2012 8:16 AM, Phil Snow Leopard wrote:
>> I think the answers are in your post.
>> 1. Cost.
>> 2. The internet, and more specifically, community forums that provide free technical help and establish a user community around the product. This provides several benefits:
>> — a free marketing tool that has greater credibility than in-house marketing because enthusiasm comes from customers, not the company
>> — a huge database of customer information and feedback usefule for
>> : market analysis
>> : product development
>> : customer feedback
>> To be honest, when you look at the huge pay-offs of internet-based help and the minimal cost, it remains a mystery why so many companies still produce paper documentation. The only rationale I can think of is for products where the user base or the product use is not conveniently related to online activity (like installing a shower, say) and/or the product is complex and safety critical (airplanes spring to mind, though there are of course many other more mundane examples).
>> Phil
>> Tech Writer:
>> Critical Thinking& Philosophy:
>> ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Tech Writer:

Critical Thinking & Philosophy:


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: documentation going away: From: Phil Snow Leopard
Re: documentation going away: From: John Allred

Previous by Author: Re: documentation going away
Next by Author: Re: documentation going away
Previous by Thread: Re: documentation going away
Next by Thread: Re: documentation going away

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

Sponsored Ads