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: Editing comments too harsh? From:Jim Grey <jimgrey -at- IQUEST -dot- NET> Date:Sat, 7 Sep 1996 09:24:00 EST
Vanessa L. Wilburn (vlwilburn -at- cpu -dot- com) asked:
>What do you do to *not* tread too heavily on engineer egos?
Here's what works for me:
Phrase your statements and queries to focus on the reader. "I'm not sure the
reader will understand what you mean by ______. Can you clarify?" This helps
keep the author from feeling like it's you vs. him/her.
Don't try to teach effective writing or proper grammar and usage in your
edits. Just make the corrections and query, "I think my changes will make
this paragraph easier for users to understand. OK?" If the author questions
such an edit, then give him or her the reason.
Peace,
jim
--
jim grey |"Ain't nothin' better in the world, you know
jimgrey -at- iquest -dot- net|Than lyin' in the sun, listenin' to the radio!"
|http://www.iquest.net/~jimgrey/
TECHWR-L List Information
To send a message about technical communication to 2500+ list readers,
E-mail to TECHWR-L -at- LISTSERV -dot- OKSTATE -dot- EDU -dot- Send administrative commands
ALL other questions or problems concerning the list
should go to the listowner, Eric Ray, at ejray -at- ionet -dot- net -dot-
