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:Re: Lingua Franca Today From:Andrew Plato <intrepid_es -at- yahoo -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Tue, 15 Jan 2002 10:38:22 -0800 (PST)
"kelley" <kwalker2 -at- gte -dot- net>
> it's not a technical document. we;ve had this debate on the list
frequently
> enough. not all of us write user help manuals, nor do we write software
> documentation. as i explained elsewhere, our clients actually pay for
the
> writing we do for them _because_ it is literate and makes cultural
> references in "flowery" language. this particular project is more akin
to
> science journalism like the kind Sharon Begley of Newsweek writes. It's
> more like journalism, i suppose. Begley, of course, uses words like
enmity
> and opprobrium when other words would certainly do.
Well, like I said, considering that 1/3 of your readers did not know what
it meant, it seems pretty obvious that it is a bad choice of words.
And just because Skip Snooty of The Weekly Snob uses big
important-sounding words, doesn't mean you have "carte blache" to use them
as well.
Haw haw...now I get it. You lifted a section of that Business Week
article. So now not only are you using flowery words (which are honestly
inappropriate for the article as well) but you're also just ripping off
text from articles.
Quote from "Toward More Cybersecurity", by Alex Salkaver: "When a company
sends data from New York to New Dehli across the networks of AT&T, France
Telecom, and others, all the routers speak BGP -- moving traffic easily
without misrouting or losing it."
Which sounds a lot like your: "When a company needs to move information
from Manhattan to Milan in the click of a mouse, routers speak BGP to one
another in order to move network traffic without losing it. "
Both of you have mis-explained BGP. Thus demonstrating one of the most
fundamental problems in many technical documents. the writer did not
understand the material and tried to compensate for this by merely
dressing up other people's text.
The problem with dressing up information you don't comprehend, is that you
run the risk of obfuscating the real concepts and alienating your
audience, which is apparently what happened to you.
Andrew Plato
__________________________________________________
Do You Yahoo!?
Send FREE video emails in Yahoo! Mail! http://promo.yahoo.com/videomail/
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Collect Royalties, Not Rejection Letters! Tell us your rejection story when you
submit your manuscript to iUniverse Nov. 6 -Dec. 15 and get five free copies of
your book. What are you waiting for? http://www.iuniverse.com/media/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.