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.
You're the third person who has written to
say I'm in fine fettle this morning.
Actually, I'm trying to avoid a particular
project...
I just got this... ah... doc to edit,
written by an ESL engineer, in question and
answer format. Yep, twenty-seven pages of
level-one headings like "So, what's the 'Do'
and 'Don't' in the untracker process?" and
"What would be the risk of not running or
finishing untracker process?"
It's hard to know where to start, since it's
pretty much free of meaningful structure.
The second half of the doc has no relation
to the title (which is the name of a software
tool we use) - it's about an entirely
different tool. Did I mention that the sample
results (from the CLI) are all uncommented?
Apparently, someone in the engineering
hierarchy said something like "We need to
document everything", and this is the result.
Not the first of this sort I've had in the
last few days.
<sigh>
Hold me back! I feel a limerick coming on.
Dan
Dan Hall
Sr. Technical Writer
SchlumbergerSema RTEMS
-----Original Message-----
From: Bill Buckheit [mailto:kcbillb2 -at- kc -dot- rr -dot- com]
Sent: Monday, May 06, 2002 1:23 PM
To: Dan Hall
Subject: Re: FW: indian newbie
Dan,
You might just possibly have too much time on your hands today.
Bill
Never been into Shakespeare much myself.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Free copy of ARTS PDF Tools when you register for the PDF
Conference by April 30. Leading-Edge Practices for Enterprise
& Government, June 3-5, Bethesda,MD. www.PDFConference.com
Buy RoboHelp Office in May and you'll save $100 with our mail-in rebate.
Or switch from Doc-to-Help or ForeHelp to RoboHelp Office for only $499.
Get the help authoring tool PC magazine recently awarded a perfect score!
Go to http://www.ehelp.com/techwr
---
You are currently subscribed to techwr-l as: archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit http://www.raycomm.com/techwhirl/ for more resources and info.
