Re: The Problem With Keeping It Plain And Simple?

Subject: Re: The Problem With Keeping It Plain And Simple?
From: Tony Markos <ajmarkos -at- yahoo -dot- com>
To: Geoff Hart <ghart -at- videotron -dot- ca>, TECHWR-L <techwr-l -at- lists -dot- techwr-l -dot- com>
Date: Sat, 22 Apr 2006 09:22:12 -0700 (PDT)

Tony Markos noted:

Good technical writing is so
simple and straight forward, they will wonder what
took you so long.

Geoff Hart responded:

Not necessarily.....

Tony Markos:

I noticed that the last part of your e-mail address is
"ca" (sorry, I forget what technically the last part
of an e-mail address is called). If it stands for
California, then I think I know where your comming
from. It has been my experience that in the more
ledging-edge parts of the country, "Not necessarily"
is more common than in lets say Cleveland. That said,
there are many more Clevelands than Silicon valleys
(or Sorrento valleys, or Austin Texases)


Your article on metrics is very informative

In it you state:

"The classic example of a metric that targets the
wrong problem is the one that specifies writing a
minimum number of pages per hour. We all know that
it?s easier to explain even a simple concept in 20
words than in 10, so that metric will have the
unintended consequence of longer documents.
Unfortunately, that's not what our managers and our
clients really need."

My opinion:

You state that we all know that it is easier to
explain a simple concept in 20 words than in 10, yet,
on the other hand, it has been my expereince that
performance measurement based on a pages-per-hour
rules (I attended a STC special meeting on estimating
where a pages-per-hour focus was firm gospel). If all
of this is true, it does not say alot in the positive
about the capacity for human beings to be honest.

Tony Markos

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

WebWorks ePublisher Pro for Word features support for every major Help
format plus PDF, HTML and more. Flexible, precise, and efficient content
delivery. Try it today!.

Doc-To-Help includes a one-click RoboHelp project converter. It's that easy. Watch the demo at

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.


The Problem With Keeping It Plain And Simple?: From: Geoff Hart

Previous by Author: What Energizes You? Was: What Pet Peeve makes you puke?
Next by Author: Re: The Problem With Keeping It Plain And Simple? (take II)
Previous by Thread: The Problem With Keeping It Plain And Simple?
Next by Thread: Re: The Problem With Keeping It Plain And Simple?

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

Sponsored Ads