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.
Subject:I just experienced the coolest thing From:John Posada <JPosada -at- book -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Thu, 9 Jan 2003 13:42:59 -0500
Part of my documentation involves diagnosing errors described though error
alerts output by HP Openview and resolving them. For almost a day, I've been
watching a discussion between one of the developers and the Network
Operations Center (NOC), but I was involved in something and figured it
would get resolved. Keep in mind that the developer is young, cute, easily
flustered, and the newest on the team, and the NOC is well, the
NOC...they've seen everything...a more grizzled group of techies you've
never seen, and they've been kicking the proverbial cr*p out of
her...telling her that her code sucked for it to create the errors that it
was.
Anyway, she comes to me, asking me if I had anything in the documentation
that would help her, so I showed her how to locate the error string, how to
diagnose the problem, and how to resolve it, since it turned out that the
error wasn't from the code, but from the datafeed in a connecting system.
Well...she was thrilled! She skipped off and 5 minutes later, a message gets
posted from her to about a dozen different parties, basically saying:
"I told you the error wasn't my code, but you didn't believe me. The error
is described in the Run book PDF, here's the link if you lost it: xxxx. if
you don't know how to find the error, it's on page 94. Now LEAVE ME ALONE
AND DO YOUR JOB!."
It was so cute!!
John Posada
Senior Technical Writer
Barnes&Noble.com
jposada -at- book -dot- com
212-414-6656
icq: 178047452
aim: jposada1
"When you only have two minutes to do
something that takes three, wait until you have three"
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
A new book on Single Sourcing has been released by William Andrew
Publishing: _Single Sourcing: Building Modular Documentation_
is now available at: http://www.williamandrew.com/titles/1491.html.
Help Authoring Seminar 2003, coming soon to a city near you! Attend this
educational and affordable one-day seminar covering existing and emerging
trends in Help authoring technology. See http://www.ehelp.com/techwr-l2.
---
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.