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.
>> Make it enjoyable to read...Make them *want* to read the manual.
I would love to do this, but for a couple of problems:
>- Translation..... Part of making something fun to read is using the
language to evoke images >and emotions from your readers. But my editor (and
most tech editors) doesn't like idioms or
>cute phrases.
I agree. One of my tests when I need to be certain that a passage in a
manual (such as a warning note) is clearly written, is to pass it through
Babel Fish, English to another language and back again.
>Do you have any examples of tech writing that is interesting AND
informative AND passed the
>inspection of a tech editor?
"It's extremely important to answer this question accurately, so, if there's
any doubt in your mind, repeat the test and double check ? it doesn't take
much extra time and it ensures that the results of your test will be
accurate.
against:
"If, when Conflict Catcher asks you whether or not the problem is still
around, you deliberately lie, then you deserve what you get. But, if you
answered the question incorrectly by accident, keep in mind you can "rewind"
the conflict test without having to start over."
Incidentally, there appears to be no particular advantage in translation, as
far as the Babel Test is concerned:
"It is extremely important to answer this question exactly, if there is some
doubt in its mind, relaunches therefore, the test and the double check. it
does not take much additional hour and one makes sure that the results of
their test are exact."
against:
"If, when Conflict Catcher asks to him if or the problem still is not
around, you lie deliberately, then you deserve what you obtain. But, if you
answered the question by accident incorrectly, he remembers that you can "
rewind " the test of the conflict without having to begin above."
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.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Did you know you can get RoboHelp certified?
To learn how, visit http://www.ehelp.com/techwr. Be sure to also check out
our special pricing offers and promotions for RoboHelp 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.
