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: Honestly -- when an SME completely REWRITES your text ... GEEZ!
Subject:RE: Honestly -- when an SME completely REWRITES your text ... GEEZ! From:"Downing, David" <DavidDowning -at- users -dot- com> To:"McLauchlan, Kevin" <Kevin -dot- McLauchlan -at- safenet-inc -dot- com>, <techwr-l -at- lists -dot- techwr-l -dot- com> Date:Thu, 23 Oct 2008 09:02:53 -0500
Holy misplaced modifier, Batman, you mean some technical writing
departments don't have editors?
I can't imagine working without an editor as a safety net -- although I
suppose everyone here who does contracting is in that position.
The only problem with having an editor is that when one editor id
replaced with another -- which has happened many times -- you have to
get used to the subjective preferences of the new editor.
When I first started here, I suffered a bit of culture shock concerning
dealing with an editor. When I do my own writing, I always wait until I
have what I consider a final draft to do the spell check because my
first drafts tend to be prolix, and I don't want to waste time
spell-checking a bunch of test that going to be cut. I didn't realize
that when you're working with an editor, you CAN'T expect them to live
with such an arrangement, and I caught it good.
-----Original Message-----
From: McLauchlan, Kevin [mailto:Kevin -dot- McLauchlan -at- safenet-inc -dot- com]
Sent: Thursday, October 23, 2008 9:47 AM
To: Downing, David; techwr-l -at- lists -dot- techwr-l -dot- com
Subject: RE: Honestly -- when an SME completely REWRITES your text ...
GEEZ!
Downing, David quoted an e-mail he sent to his SME:
[...]
> Here's what I cam up with as the revised text for the [snip] Table.
> This is a kind of hybrid of what you sent me and what was there. Your
> text included some I important points I missed, such as [snip].
However,
> I couldn't use it verboten because it wasn't in line with our
department
> style. Furthermore, I thought some points were better placed in an
> introductory section, rather than in the discussion of the fields. I
> also felt that in some places where you referred to the [snip] code,
the
> reference should really be to the table entry, since we're talking
about
> the actually [snip] data, not just the code. I also had some passages
I
> really want to keep from my original. This has created some
redundancy,
> but I figured it would ultimately be up to our editor how to resolve
> this.
[...]
Editor? You've got... EDITors?
Holy Moley, Batman! Some of these techwriter people have... gasp!...
actual editors.
I need to sit down.
Wait.
I _am_ sitting.
I need to lie down.
- Kevin
The information contained in this electronic mail transmission
may be privileged and confidential, and therefore, protected
from disclosure. If you have received this communication in
error, please notify us immediately by replying to this
message and deleting it from your computer without copying
or disclosing it.
ComponentOne Doc-To-Help 2009 is your all-in-one authoring and publishing
solution. Author in Doc-To-Help's XML-based editor, Microsoft Word or
HTML and publish to the Web, Help systems or printed manuals. http://www.doctohelp.com
True single source, conditional content, PDF export, modular help.
Help & Manual is the most powerful authoring tool for technical
documentation. Boost your productivity! http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-