RE: Trends in Tech Comm

Subject: RE: Trends in Tech Comm
From: "Steve Janoff (non-Celgene)" <sjanoff -at- celgene -dot- com>
To: "techwr-l -at- lists -dot- techwr-l -dot- com" <techwr-l -at- lists -dot- techwr-l -dot- com>, Tony Chung <tonyc -at- tonychung -dot- ca>
Date: Wed, 1 Feb 2012 22:26:09 -0800

I agree with what you say, and at the same time I feel that there is an added dimension that is, over time, being drained out of documentation, which is the writer's personality. In an era where consistency is a major goal, that may be fine.

And yet, for me, it's a special occasion when I read something that's not only usable but also compelling. This gets into the "user experience" of documentation. It's more than just, "I got the information I needed." It's more like, "Wow, that was really well done!" Maybe it's just one writer appreciating the work of another.

But I hate to see the "writer" taken out of the technical writer, is all I'm saying.

A while back there was a thread on good tech writing of old, and I remember the book by John Muir was mentioned, on "Keeping Your Volkswagen Alive." I never read it, merely perused it, but I know what a classic it was. You can't write that kind of work anymore, at least not as a tech writer -- and maybe you never could, unless you went to the after market.

But I feel that a writer's personality can still be maintained even with the automated writing tools of today. It's the difference between good documentation and great documentation. "Good" is good enough, but I really like "great." I especially like reading it, even if I can't write it.

Maybe I'm just lamenting the loss of individualism that comes with standardization. Or, it could depend on how you come into tech writing: as a writer, a journalist, a scientist, a researcher, etc. On that basis, the loss of the writer's individualism is a very personal thing.


-----Original Message-----
From: Tony Chung [mailto:tonyc -at- tonychung -dot- ca]
Sent: Wednesday, February 01, 2012 9:12 PM
To: Steve Janoff (non-Celgene)
Cc: techwr-l -at- lists -dot- techwr-l -dot- com
Subject: Re: Trends in Tech Comm

I think the core skill of researching products to discuss at a higher
level than the individual developer will still prevai. The only
difference is the number of ways we write the sentence.

Technical Writing has less to do with eloquence and everything to do
with relevance. We need to provide information of value to the end
user for the task at hand. If I, as a tech writer, cannot envision (or
be convinced of) how a potential end user will use our product, then I
won't be able to do a good job of placing the reader into the product.

While we spend some time writing definitions, the end goal is to be
sure someone knows how to put those definitions to use.

So, while the technical skill will be needed (which is where I spend
the bulk of my time), there also needs to be that raw journalistic
instinct of getting to the bottom of he story.

The DITA Open Tool Kit never supposes to do that.


If the reader is not the intended recipient, or the
employee or agent responsible to deliver it to the
intended recipient, you are hereby notified that any
dissemination, distribution or copying of this
communication is strictly prohibited. If you have
received this communication in error, please reply to the
sender to notify us of the error and delete the original
message. Thank You.


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 @


Trends in Tech Comm: From: Steve Janoff (non-Celgene)
RE: Trends in Tech Comm: From: Steve Janoff (non-Celgene)
Re: Trends in Tech Comm: From: Tony Chung

Previous by Author: RE: Trends in Tech Comm
Next by Author: RE: Trends in Tech Comm
Previous by Thread: Re: Trends in Tech Comm
Next by Thread: Re: Trends in Tech Comm

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

Sponsored Ads