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: Real world ethical questions From:John Posada <JPosada -at- book -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Mon, 14 Apr 2003 14:40:19 -0400
> Product X is intended for financial institutions, where security is
> important. There's a login/password authentication system. But, the
> product uses Internet Explorer as the interface. It's easy to bypass
> the system. I documented that, but the product manager told me to take
> it out, not because it wasn't true, but because he didn't want people
> to know it worked that way.
Your job is not to explain to people how to crack your system. It is to
explain how it works. Many of us document servers. We may not think it is
secure enough. Is it our obligation to explain back doors because we aren't
satisfied with the security of the server?
If you did, and during an interview, you showed me the alternate
documentation where you DID put that in writing, you'd be the LAST person on
my list that I'd call.
Ethics has nothing to do with it. Scope is. The scope of your documentation
is to document how to use the product.
John Posada
Senior Technical Writer
Barnes&Noble.com
jposada -at- book -dot- com
NY: 212-414-6656
Dayton: 732-438-3372
Although she lives with seven other men, she's not easy.
------ Magic Mirror
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Purchase RoboHelp X3 in April and receive a $100 mail-in
rebate, plus FREE RoboScreenCapture and WebHelp Merge Module.
Order here: http://www.ehelp.com/techwr-l/
Help celebrate TECHWR-L's 10th Anniversary starting this month!
Check out the contests at http://www.raycomm.com/techwhirl/special/contests/
Happy birthday to you, happy birthday to you, happy birthday TECHWR-L....
---
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.