RE: Formatting Docs On-The-Fly

Subject: RE: Formatting Docs On-The-Fly
From: "Etzel, Gary" <Gary -dot- Etzel -at- Advantica -dot- biz>
To: techwr-l -at- lists -dot- techwr-l -dot- com
Date: Thu, 15 Dec 2005 13:59:53 -0500

> If for example, the standard formatting calls for
> right-size numbered steps (written in the active
> voice), if I have "holes" in my understanding of the
> subject matter, I can try and hide such by switching
> to unnumbered (read: often non sequential), large
> paragraphs written in puffed up, vague,
> non-active-voice language.

I can't speak for where you worked, but a style change that drastic would
send up an immediate red flag here. It would draw attention to itself,
rather than mask any problems. I can't imagine a writer could get away with
that. Sooner or later, somebody is going to read it.

> Rationale: If they can't establish the flow of it
> and/or get specific with it, then maybe they will not
> be able t see the holes in it. Happened all the time
> at the DOD agency which I contracted at. (Often times
> such text was prefixed with a statement like "The
> procedure to do X is simple.")

As a manager, I can teach a writer how to get information from SMEs and
other resources, to fill in the documentation gaps. But I would be much more
disturbed by deliberate attempts to deceive me, and ultimately, my
customers. Tony, do you know for sure that this was purposely done? Could
the issue be that they were not properly trained or were not competent
enough to do the job right?
This e-mail, and any attachments are strictly confidential and intended for the addressee(s) only. The content may also contain legal, professional or other privileged information. If you are not the intended recipient, please notify the sender immediately, by return of email, and then delete the e-mail and any attachments. You should not disclose, copy or take any action in reliance on this transmission.

Please ensure you have adequate virus protection before you open or detach any documents from this transmission.

______________________________________________________________________
This email has been scanned by the MessageLabs Email Security System.
For more information please visit http://www.messagelabs.com/email
______________________________________________________________________
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

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! http://www.webworks.com/techwr-l

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. http://www.componentone.com/TECHWRL/DocToHelp2005

---
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 http://lists.techwr-l.com/mailman/options/techwr-l/archive%40infoinfocus.com

Send administrative questions to lisa -at- techwr-l -dot- com -dot- Visit
http://www.techwr-l.com/techwhirl/ for more resources and info.


Previous by Author: RE: Formatting Docs On-The-Fly
Next by Author: RE: Formatting Docs On-The-Fly
Previous by Thread: RE: Formatting Docs On-The-Fly
Next by Thread: RE: Formatting Docs On-The-Fly


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

Sponsored Ads


Sponsored Ads