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.
Two things jump out at me on this issue. First, you have an SME Engineer making
this claim that the repetition is numbing or boring the readers. Is there any
objective data to bear this assertion out? You have one person making a
specific claim. Can you test the assertion (or have the complaining SME test
it) for validity?
BTW, I can imagine a scenario where repetition would be necessary. If the
overall procedure is comprised of sub-procedures that can themselves be
executed independently of the overall procedure, you would need the cautions in
all the places where a user would enter the sub-procedure without having
started it from the beginning.
The second issue that I noticed is the question of legal liability. Just
because it's bad writing (if it is) it may be dictated by your corporate legal.
Be they drones or splendid legal minds, you are well-advised to follow their
legal advice. Otherwise YOU risk exposing the organization and yourself to
consequences you, and they, would rather avoid.
__________________________________________________
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.
