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: Ethics in Technical Writing From:Lauren <lauren -at- writeco -dot- net> To:techwr-l -at- lists -dot- techwr-l -dot- com Date:Mon, 1 May 2017 12:42:51 -0700
I’m not discussing the “phrase in question,” I’m discussing the ethical
principle that the discussion about the phrase raised. Perhaps you do
not value ethics in technical writing. Your statement about the phrase
being “an actual quote or just some random jargon,” underscores the need
of technical writing ethics. The lack of discussion on the subject of
ethics underscores a lack of interest in ethics among technical writers.
It is artificial job security when documentation is wrong and the
technical writer can blame the SME because the technical writer will be
called on to fix bad documentation. That approach is not ethical. We do
not know what the original phrase was but for all posterity, technical
writers freely provided opinions on how to make a bad instruction
grammatically correct, while the grammatical correction could change the
instruction.
Ethics, if any are followed, would be breached if grammatical rules were
followed over the accuracy of instruction. It is a dangerous practice if
ethics like this are never followed. So why is it that technical writers
neither discuss nor care to follow ethics? Why are SMEs held accountable
for bad instruction when a technical writer may be the last person to
see a document before it is released and can determine if an instruction
is vague?
On 4/30/2017 10:49 AM, Robert Lauriston wrote:
You guys have certainly gone to remarkable lengths in discussing this
given that we don't know whether the phrase in question was an actual
quote or just some random jargon the original poster made up in the
style of his English-challenged SMEs.
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Visit TechWhirl for the latest on content technology, content strategy and content development | http://techwhirl.com
You are currently subscribed to TECHWR-L as archive -at- web -dot- techwr-l -dot- com -dot-
To unsubscribe send a blank email to
techwr-l-leave -at- lists -dot- techwr-l -dot- com