Re: An interview question

Subject: Re: An interview question
From: phil stokes <philstokes03 -at- googlemail -dot- com>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Fri, 29 Mar 2013 21:47:43 +0700

On 29 Mar 2013, at 21:00, Lynne Wright <Lynne -dot- Wright -at- tiburoninc -dot- com> wrote:

I think that the correct answer is that although a company might not see a
direct monetary return on the cost of documentation, well-written,
comprehensive manuals and on-line help can increase customer satisfaction.

Hmm, interesting point. In one of those moments of synchronicity, I just
happened to read an Apple doc this afternoon that ironically stated, among
other things, that:

A principal goal of object-oriented programming is to make the code you
write as reusable as possibleâ.Reusability is influenced by factors such as

***How clear the documentation is***


I say "ironically" as Apple docs are about as frustrating as any docs I've
ever read. With the exception of comprehensiveness, in any other terms,
their work falls so far below professional standards of good technical
writing it beggars belief.


From our sponsor Doc-to-Help: Want to see a Doc-To-Help web-based Help sample with DISQUS for user commenting?

Learn more:


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

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 @


An interview question: From: Peter Neilson

Previous by Author: Re: remove spaces from Word
Next by Author: Re: An interview question
Previous by Thread: Re: An interview question
Next by Thread: RE: An interview question

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

Sponsored Ads