Re: documentation going away

Subject: Re: documentation going away
From: Lauren <lauren -at- writeco -dot- net>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Mon, 16 Jan 2012 15:48:08 -0800

Dossy, are you saying that employers are hiring technical writers to use Wikipedia in order to produce support documentation? My prediction is that employers will hire technical writers to use the content from the company's support forums as a basis for company documentation. As though the content in the support forum is a rough draft.

Employers often seem to think that they can cut time and expenses by requiring that technical writers use various forms of in-place documentation and that employers may start to consider these support forums are in-place documentation. Generally, for me, it is easier and faster to produce documentation from scratch with interviews and use of the system or product, but also use in-place documentation as a reference and possible starting point.

I think it would be potential nightmare if an employer said, "we need you to document what is on Wikipedia and what is in our support forums because that is the only documentation we have for our product." I would do the job, but I would charge a lot.


On 1/16/2012 3:37 PM, Dossy Shiobara wrote:

On 1/16/12 6:18 PM, Lauren wrote:
I have a scary prediction that may even be in place now. I think that companies will hire technical writers to document the content in forums. Hiring managers may probably say, "All of the support documentation is in the forums, you just need to clean it up."

Yes, this model already exists. It's called Wikipedia. The upside is a tremendous, quasi-useful resource, which turns the 4+ billion documents available on the Internet into half-baked reference material. The downside is that it requires tens of thousands of editors to accomplish such a task, and it's only as accurate as the original sources the information is extracted from.

The buzzword for this is "content curation" ...


^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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.
http://www.doctohelp.com

---
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 http://lists.techwr-l.com/mailman/options/techwr-l/archive%40web.techwr-l.com


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
http://www.techwhirl.com/email-discussion-groups/ for more resources and info.

Looking for articles on Technical Communications? Head over to our online magazine at http://techwhirl.com

Looking for the archived Techwr-l email discussions? Search our public email archives @ http://techwr-l.com/archives


References:
Re: documentation going away: From: Phil Snow Leopard
Re: documentation going away: From: John Allred
Re: documentation going away: From: Phil Snow Leopard
Re: documentation going away: From: Connie Giordano
Re: documentation going away: From: Gene Kim-Eng
Re: documentation going away: From: Connie Giordano
RE: documentation going away: From: McLauchlan, Kevin
Re: documentation going away: From: Suzanne Chiles
RE: documentation going away: From: Porrello, Leonard
Re: documentation going away: From: Suzanne Chiles
Re: documentation going away: From: Gene Kim-Eng
RE: documentation going away: From: McLauchlan, Kevin
Re: documentation going away: From: Lauren
Re: documentation going away: From: Dossy Shiobara

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