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: Do I REALLY have to understand the material? From:"Miller, Alan" <Alan -dot- Miller -at- prometric -dot- com> To:"TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com> Date:Tue, 20 Aug 2002 09:25:35 -0400
Andrew wrote, in part:
<snip>
>>> 6. If I document, for example, manufacturing programs, its more important for me to understand the manufacturing process than the language that the programs use.
Yes. But learning the programming languages surely won't hurt your ability to understand and document manufacturing processes.
<snip>
Actually, Andrew, learning the programming language in this instance is essential. The details of how the process works are buried in the coding in the process controllers (Programmable Logic Controllers). The PLCs for a conveyor, for example, will control how the conveyor starts and stops under normal conditions, what the safety interlocks are, what the parameters and set points that control the conveyor speed and loading are, what will cause an emergency shutdown, and what conditions will cause warning alarms. These and other settings are not made at the factory and are not in the vendor's manual. A controls engineer at the site programs the PLCs and tests the system, he will document the code he used. If the writer can't read the programming code, he'll never figure out how the durn thing works.
Al Miller
Chief Documentation Curmudgeon
Prometric, Inc., a part of the Thomson Corporation
Baltimore, Maryland
In America, anybody can be president. That's one of the risks you take.
-- Adlai Stevenson
Check out the new release of RoboDemo, our easy-to-use tutorial software.
Plus, buy RoboHelp Office in August and save $100 with our mail-in rebate.
Get details and download free trial versions at http://www.ehelp.com/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.