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: If You Were Gonna Teach... From:"Jane Carnall" <jane -dot- carnall -at- digitalbridges -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Thu, 7 Mar 2002 16:20:08 -0000
Tom Murrell asks:
> But what
I'm really interested in are the four or five things that you would like to
your contributors stop doing or do better that would improve both document
writing (Requirements, Designs, etc.) and even email communications.>
1. Not to add their own brand new styles to Word. (This is a Tools thing,
not a writing thing, but there is almost nothing they can do that will cause
me more trouble.)
2. One idea, one sentence. One sentence, one idea.
3. Commas are not rationed. (Seriously, a brief outline of basic punctuation
and how it is used to structure sentences, done in some memorable fashion
with humourous yet accurate examples, would do as much as anything else
would for comprehension.)
4. The difference between company argot, industry jargon, and plain English.
-Company argot is the terms this company has invented for the things it
does. If there is already a generally-understood *within the industry*
jargon term for the same thing, consider using jargon rather than argot.
-Industry jargon is widely understood by people who work in a specific area:
if the document is intended for users within that area, use the jargon term:
if it is intended for newcomers and/or for people outside the area, or if
there is no one generally understood jargon term, include a definition in
Technical Writer, Digital Bridges, Scotland
Unless stated otherwise, these opinions are mine, and mine alone. Apologies
for the long additional sig: it is added automatically and outwith my
E-mail is an informal method of communication and may be subject to data corruption, interception and unauthorised amendment for which Digital Bridges Ltd will accept no liability. Therefore, it will normally be inappropriate to rely on information contained on e-mail without obtaining written confirmation.
This e-mail may contain confidential and/or privileged information. If you are not the intended recipient (or have received this e-mail in error) please notify the sender immediately and destroy this e-mail. Any unauthorized copying, disclosure or distribution of the material in this e-mail is strictly forbidden.
Check it out! Get some cool freebies when you buy RoboHelp! You'll receive
SnagIt screen capture software and a 10% discount voucher for RoboHelp
Consulting. This special offers expires March 29, 2002.
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.