TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Re: ååï What are the perquisites to set up a company's documentation group from scratch
Subject:Re: ååï What are the perquisites to set up a company's documentation group from scratch From:Ken Poshedly <poshedly -at- bellsouth -dot- net> To:Peter Neilson <neilson -at- windstream -dot- net>, Gene Kim-Eng <techwr -at- genek -dot- com>, Simon <wingman1985 -at- yahoo -dot- com -dot- cn> Date:Tue, 16 Jul 2013 03:15:20 -0700 (PDT)
The comments in this discussion (as well as the other one on " Why is so hard to for majority Chinese companies to take documentation seriously?")Â are so very true.
As I've written in the past, I (a native-born American from the midwest) am a tech writer at the metro Atlanta office of a Chinese manufacturer of heavy equipment. The company is HUGE in mainland China, but still grasping to gain sizable marketshare elsewhere; it has also established offices in and distributes its products to Germany, India and Brazil and competes on lowest price.
Absolutely great people, but the comment about the docs being written by engineers is exactly what I face. (I don't know if they're disgruntled or not, though.) The accuracy level of what I am sent as source data is way below what should be -- especially considering that one can get killed working with this stuff. (I spend weeks trying to get corrected engineering data so my books are at least accurate.)
And the comment about the cultural differences is also correct, and that is what I've been told many times by my folks in China. Equipment owners there simply don't mess with the manuals. Instead, they contact the company which sends out an army of technicians.
My comments to Chinese staff here about product liability results in blank stares, so you can imagine what that can mean for stuff being delivered right off the assembly line in China to customers with little or no testing.
Also, the profession of "technical writer" -- or at least recognition of specialists like us -- does not exist in China. Again, this is right from those in China. Yes, there are some very good "technical writers" there, but after over four years with my company (and four visits to various cities there for research), I have found very, very, very few.
So my task of producing suitable documentation for my North American customers remains an uphill battle.
-- Ken in Atlanta
>________________________________
> From: Peter Neilson <neilson -at- windstream -dot- net>
>To: Gene Kim-Eng <techwr -at- genek -dot- com>; Simon <wingman1985 -at- yahoo -dot- com -dot- cn>
>Cc: "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>
>Sent: Tuesday, July 16, 2013 5:46 AM
>Subject: ååï What are the perquisites to set up a company's documentation group from scratch
>
>
>On Tue, 16 Jul 2013 02:41:12 -0400, Simon <wingman1985 -at- yahoo -dot- com -dot- cn> wrote:
>
>> The docs are there (written by disgruntled engineers). However, the accuracy and relevance as well as compliance is very poor. No dedicated resources are provided for this effort.
>
>I fear that you will find yourself shoveling sand against the tide. Here, in my usually jaundiced view, are a few of the many problems you will face.
>
>1. There will be resistance to providing good reviews, as we discussed earlier.
>2. Some reviews might consist of reversion of the document to exactly as it was before you made any changes.
>3. Reviewers might attempt to correct use of language but carefully avoid the seething technical issues.
>4. You'll be unable to assemble criteria by which you can know that any part of the documentation effort is complete.
>5. You'll be unable to discover the identity of the intended audience.
>6. You'll discover that a rough draft has been shipped as if it were a completed document.
>7. Some of the original documentation that you'll be handed (as starting material) will turn out to be copied directly from competitors' literature or from Wikipedia. (Google for unique phrases. You might be amazed!)
>8. Your very best SME will suddenly be reassigned to a different project, elsewhere, leaving your doc project in limbo.
>9. You will find that your polished English-language effort has been translated into Chinese (for top-level review) and then back to almost-English before being sent to customers.
>10. You will lose effectiveness because you are seen as too pushy.
>11. You will discover that you have been unable to spend enough time doing actual documentation because you got subverted into helping friends learn English.
>12. As you add other writers to your doc group, you will encounter all the standard problems of managing them. "Herding cats" is the usual metaphor. Try to develop performance criteria as well as standards.
>
>I'm not saying that the task is impossible, but that you'll need flexible plans that can handle problems that suddenly arise from nowhere. And yes, having some sort of method for tracking the changes to your documents will be very important. In particular you must avoid a losing control of your "master" copy of each document. Something like SVN can let you rewind to a previous version and undo misapplied changes.
>
>
>^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.
>
>Learn more: http://bit.ly/ZeOZeQ
>
>^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
>
>You are currently subscribed to TECHWR-L as poshedly -at- bellsouth -dot- net -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
>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
>
>
>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
New! Doc-to-Help 2013 features the industry's first HTML5 editor for authoring.