Re: On the value of technical communication (long)

Subject: Re: On the value of technical communication (long)
From: "Bill Swallow" <techcommdood -at- gmail -dot- com>
To: "Peter Neilson" <neilson -at- windstream -dot- net>
Date: Sat, 27 Dec 2008 00:47:43 -0500

> Will they actually change their views, and decide to integrate technical
> writing into the effort, or will they seek out someone to blame for the
> catastrophe? Will they modify their risk strategy and look to design a
> properly written set of documents, or will they want some kind of patch
> thrown together in two weeks at minimum cost?

I've seen trends to include TWs into the effort but resistance to
abandon the tossed-together patch. It's a case of wanting both to
improve and to quickly appease customers. Many companies just can't
see the value in ditching the patch mentality to truly give
improvement its all.

> If they do embark on a revised but even bigger replacement project (with
> integrated documentation teams) for which the design is conceptually
> flawed, will they blame the project's failure on the technical writer
> who discovers and points out the flaw?

I doubt it's that granular, but if flaws are pointed out in the end
rather than up front there will certainly be heated discussion no
matter who brings it up. It comes down to the 1:10:100 rule, where it
costs 1 unit to do it right, 10 units to fix it mid-stream, and 100
units to fix it post ship. No one likes to be faced with a 10 or 100
weight issue, but again, many companies fail to plan properly to
strengthen the 1 weight effort.

> Will any of these folks ever see any need for further technical writing
> at all? What am I doing staying in this business?

Good question! Technical writing isn't their main concern. Quality
product and efficient effort is or should be. Technical writing goes
lock step with QA, Development, HCI, and other efforts, and it's up to
everyone in those areas to ensure they are involved at the beginning
and through the life of the project. Of course it takes good
leadership to ensure that all parties are given equal weight and
involvement in the effort as well.

--
Bill Swallow
http://techcommdood.blogspot.com
http://twitter.com/techcommdood

Avid homebrewer and proud beer snob.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals.
http://www.doctohelp.com

Help & Manual 5: The complete help authoring tool for individual
authors and teams. Professional power, intuitive interface. Write
once, publish to 8 formats. Multi-user authoring and version control! http://www.helpandmanual.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-unsubscribe -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.techwr-l.com/ for more resources and info.

Please move off-topic discussions to the Chat list, at:
http://lists.techwr-l.com/mailman/listinfo/techwr-l-chat


References:
On the value of technical communication (long): From: Steven Jong
Re: On the value of technical communication (long): From: Gene Kim-Eng
Re: On the value of technical communication (long): From: Peter Neilson

Previous by Author: Dutch Auction (was: Sr Tech Writer job)
Next by Author: Re: Salary, Negotiation, and Salary Requirement/Total Compensation
Previous by Thread: Re: On the value of technical communication (long)
Next by Thread: Re: On the value of technical communication (long)


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


Sponsored Ads