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.
Ned Bedinger noted: <<I want to explore some new ground: I detect a
dark star lurking at the center of our sense of what is jargon.>>
Careful... dark starts tend to generate much more heat than light!
<gdrlh>
<<The word jargon can be defined across a pretty darned huge
conceptual range, so I don't think it has much utility, even as one
of the individual definitions, to a tech writer.>>
Good point. And that range spans the spectrum from incomprehensible
elitist gibberish (most of the contents of _Social Text_, for
instance) to words that communicate effectively both within and
between audiences (like most of the science I edit). So rather than
dissing (both discussing and disrespecting <g>) jargon per se, it's
wise to define our terms carefully from the start.
<<The argument, so it goes, is that jargon isn't a problem for
technical writers, it is a problem for the audience. I still have a
problem with jargon in this sense. I expect that the majority of what
we filter out of documentation as jargon is actually not about the
words at all. It is rather about the concepts underlying the words.>>
That's an interesting division. I tend to use the phrase "(in)
appropriate jargon" to focus on your first point: it's not so
important whether a word is technical, but rather whether its level
of technicality is appropriate for the readers. That leads neatly
into your second point, which is that sometimes we should be focusing
on the concept's relevance to the reader before we worry about the
choice of words to convey that relevance.
----------------------------------------------------
-- Geoff Hart
ghart -at- videotron -dot- ca / geoffhart -at- mac -dot- com
www.geoff-hart.com
--------------------------------------------------
Coming soon: _Effective onscreen editing_ (http://www.geoff-hart.com/
home/onscreen-book.htm)
Create HTML or Microsoft Word content and convert to Help file formats or
printed documentation. Features include support for Windows Vista & 2007
Microsoft Office, team authoring, plus more. http://www.DocToHelp.com/TechwrlList
Now shipping: Help & Manual 4 with RoboHelp(r) import! New editor,
full Unicode support. Create help files, web-based help and PDF in up
to 106 languages with Help & Manual: http://www.helpandmanual.com
---
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-