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: STC and words From:Shea Michael EXT <Michael -dot- Shea -dot- extern -at- icn -dot- siemens -dot- de> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Tue, 5 Nov 2002 09:31:42 +0100
Andrew,
While no one will disagree with you that without content a document is useless, communication is not content. Communication is the means to transport content.
>From Merrian-Webster:
com·mu·ni·ca·tion
1. The act of communicating; transmission.
The exchange of thoughts, messages, or information, as by speech, signals, writing, or behavior.
Interpersonal rapport.
2. The art and technique of using words effectively to impart information or ideas.
Both the what and the how of communication are equally important to end users. In your own tanker example you aptly point out that a tanker without oil is worthless. But by the same token a billion gallons of oil sitting on the dock is equally worthless without a tanker.
Extend the metaphor and we can say that a poorly constructed tanker that leaks or is slow or even sinks on its way to market does not serve its customers, just in the same way that a well constructed tanker delivering contaminated oil fails to server its customers.
I grant you that some novices spend time fussing with fancy fonts. The venerable readme.txt is a clear and straightforward means to transfer information. But is it the best way to communicate to all audiences? It may be, but that is what the rest of your peers are trying to find out, through experimentation and hard work.
Michael Shea
XpressLink Documentation
c/o ICN AS BA ST2
--------------------------------------------------------------------
Michael Shea
ROSEMANN & LAURIDSEN GMBH
Am Schlossberg 14, D-82547 Eurasburg, Germany
-----Original Message-----
From: Andrew Plato
Subject: STC and words
<snip>
Communication means to convey something. Without something to convey, there is no
communication to be done. Hence first there is content, then there is
communication of said content. Content is the raw material that allows
communication (and communicators) to exist. You are NOTHING without content to
communicate.
Now, you can focus on the mere act and methods of communicating. But that's
synonymous with analyzing the value of shipping routes based on the ships used
with no regard to what those ships haul. A huge oil tanker can haul a billion
gallons of oil (lots of money) or a billion gallons of cat urine. Since nobody
wants a billion gallons of cat urine - its pretty flipping stupid to sit around
and talk about the amazing single-tanker system you've developed if you keep
sending cat urine to people. So what goes inside the tanker is of utmost
importance to the tanker's value as well as the entire process of conveyance. A
cat urine hauling tanker is of virtually no value and hence not even worth having
around.
<snip>
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Check out SnagIt - The Screen Capture Standard!
Download a free 30-day trial from http://www.techsmith.com/rdr/txt/twr
Find out what all the other tech writers, including Dan, already know!
All-new RoboHelp X3 is now shipping! Get single sourcing, print-quality
documentation, conditional text and much more, in the most monumental
release ever. Save $100! Order online at http://www.ehelp.com/techwr-l
---
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.