Are your documents interesting?

Subject: Are your documents interesting?
From: Steven Brown <stevenabrown -at- yahoo -dot- com>
To: TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Thu, 12 Jan 2006 08:02:44 -0800 (PST)

A co-worker pointed me toward this interesting blog
entry. I really like the following quote:

"Even if your actual product is you
have docs, FAQs, specs, articles, learning/support
blogs, etc. that are NOT interesting? Should they be?"

Of course the answer is yes! The challege to us tech
writers is convincing management that users are,
well...just like us! They laugh and cry. They watch
the same TV shows, read the same magazines. They speak
informally. Why does the tone of our documents and
training not reflect what people are used to
experiencing in the larger marketplace?

Here's the full story.

And make sure you read a related story about
conversational writing.

Steven Brown
Technical Writer

Do You Yahoo!?
Tired of spam? Yahoo! Mail has the best spam protection around

Now Shipping -- WebWorks ePublisher Pro for Word! Easily create online
Help. And online anything else. Redesigned interface with a new
project-based workflow. Try it today!

Doc-To-Help 2005 now has RoboHelp Converter and HTML Source: Author
content and configure Help in MS Word or any HTML editor. No
proprietary editor! *August release.

You are currently subscribed to TECHWR-L as archive -at- infoinfocus -dot- com -dot-

To unsubscribe send a blank email to
techwr-l-unsubscribe -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 lisa -at- techwr-l -dot- com -dot- Visit for more resources and info.


Previous by Author: RE: The non-learning organization?
Next by Author: Re: Resources on estimating documentation projects
Previous by Thread: RE: Do Burned CDs Have a Short Life Span?
Next by Thread: Re: Are your documents interesting?

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

Sponsored Ads