TechWhirl (TECHWR-L) is a resource for technical writing and technical communications professionals of all experience levels and in all industries to share their experiences and acquire information.
For two decades, technical communicators have turned to TechWhirl to ask and answer questions about the always-changing world of technical communications, such as tools, skills, career paths, methodologies, and emerging industries. The TechWhirl Archives and magazine, created for, by and about technical writers, offer a wealth of knowledge to everyone with an interest in any aspect of technical communications.
Re: The Problem With Keeping It Plain And Simple? (take II)
Subject:Re: The Problem With Keeping It Plain And Simple? (take II) From:eric -dot- dunn -at- ca -dot- transport -dot- bombardier -dot- com To:Geoff Hart <ghart -at- videotron -dot- ca> Date:Mon, 24 Apr 2006 10:19:29 -0400
Geoff Hart wrote on 04/23/2006 09:49:26 AM:
> Some managers who don't know any better do use this kind of metric
> for semi-good reasons: for example, if you know that last years'
> documentation was 500 pages and took 250 hours to write, then as a
> crude guess, your writers need to hit at least 2 pages per hour to
> produce this year's version in the same length of time. Of course, that
> trivializes the work we do, but if you have no better way to estimate a
> project, I suppose it's better than nothing.
Actually, IMO, once you have a good work and production history to back
you up, then pages per hour is perfectly acceptable and in no way
trivialises how technical writers work.
You may spend more time on some topics than others, and some days produce
little or no "finished" pages. But at the end of the project, if the new
work is for a similar product, produced to the same degree of detail, and
the same level of quality. It should remain within the same pages per hour
envelope.
What's more important than the metrics is how they are interpreted and
used. So, if pages per hour (with suitable history to back up the numbers)
are used to generate deadlines and budget, no problem. If the same is used
on a weekly basis to evaluate productivity, then it's unacceptable.
This e-mail communication (and any attachment/s) may contain confidential
or privileged information and is intended only for the individual(s) or
entity named above and to others who have been specifically authorized to
receive it. If you are not the intended recipient, please do not read,
copy, use or disclose the contents of this communication to others. Please
notify the sender that you have received this e-mail in error by reply
e-mail, and delete the e-mail subsequently. Please note that in order to
protect the security of our information systems an AntiSPAM solution is in
use and will browse through incoming emails.
Thank you.
_________________________________________________________________________________________________________________
Ce message (ainsi que le(s) fichier/s), transmis par courriel, peut
contenir des renseignements confidentiels ou protégés et est destiné à
l?usage exclusif du destinataire ci-dessus. Toute autre personne est par
les présentes avisée qu?il est strictement interdit de le diffuser, le
distribuer ou le reproduire. Si vous l?avez reçu par inadvertance,
veuillez nous en aviser et détruire ce message. Veuillez prendre note
qu'une solution antipollupostage (AntiSPAM) est utilisée afin d'assurer la
sécurité de nos systems d'information et qu'elle furètera les courriels
entrant.
Merci.
_________________________________________________________________________________________________________________
(See attached file: C.htm)
<br><font size=2><tt>Geoff Hart wrote on 04/23/2006 09:49:26 AM:<br>
> Some managers who don't know any better do use this kind of metric<br>
> for semi-good reasons: for example, if you know that last years'<br>
> documentation was 500 pages and took 250 hours to write, then as a<br>
> crude guess, your writers need to hit at least 2 pages per hour to<br>
> produce this year's version in the same length of time. Of course,
that<br>
> trivializes the work we do, but if you have no better way to estimate
a<br>
> project, I suppose it's better than nothing.<br>
</tt></font>
<br><font size=2><tt>Actually, IMO, once you have a good work and production
history to back you up, then pages per hour is perfectly acceptable and
in no way trivialises how technical writers work.</tt></font>
<br>
<br><font size=2><tt>You may spend more time on some topics than others,
and some days produce little or no "finished" pages. But at the
end of the project, if the new work is for a similar product, produced
to the same degree of detail, and the same level of quality. It should
remain within the same pages per hour envelope.</tt></font>
<br>
<br><font size=2><tt>What's more important than the metrics is how they
are interpreted and used. So, if pages per hour (with suitable history
to back up the numbers) are used to generate deadlines and budget, no problem.
If the same is used on a weekly basis to evaluate productivity, then it's
unacceptable.<br>
<br>
Eric L. Dunn<br>
Senior Technical Writer<br>
<br>
_______________________________________________________________________________________________________________
<br>
This e-mail communication (and any attachment/s) may contain confidential
or privileged information and is intended only for the individual(s) or
entity named above and to others who have been specifically authorized
to receive it. If you are not the intended recipient, please do not read,
copy, use or disclose the contents of this communication to others. Please
notify the sender that you have received this e-mail in error by reply
e-mail, and delete the e-mail subsequently. Please note that in order to
protect the security of our information systems an AntiSPAM solution is
in use and will browse through incoming emails. <br>
Thank you. <br>
_________________________________________________________________________________________________________________
<br>
<br>
Ce message (ainsi que le(s) fichier/s), transmis par courriel, peut contenir
des renseignements confidentiels ou protégés et est destiné à l’usage
exclusif du destinataire ci-dessus. Toute autre personne est par les présentes
avisée qu’il est strictement interdit de le diffuser, le distribuer ou
le reproduire. Si vous l’avez reçu par inadvertance, veuillez nous en
aviser et détruire ce message. Veuillez prendre note qu'une solution antipollupostage
(AntiSPAM) est utilisée afin d'assurer la sécurité de nos systems d'information
et qu'elle furètera les courriels entrant.<br>
Merci. <br>
_________________________________________________________________________________________________________________
<br>
<br>
</tt></font>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
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!. http://www.webworks.com/techwr-l