<html><body><div style="color:#000; background-color:#fff; font-family:arial, helvetica, sans-serif;font-size:12pt"><div><br></div><hr size="1">Date: Mon, 7 Oct 2013 14:26:23 +0000<br>From: Stephen O'Brien <<a href="mailto:sobrien@innovmetric.com">sobrien@innovmetric.com</a>><br>To: "Frame Users (<a href="mailto:framers@lists.frameusers.com">framers@lists.frameusers.com</a>)"<br> <<a href="mailto:framers@lists.frameusers.com">framers@lists.frameusers.com</a>><br>Subject: Engineers as authors<br>Message-ID:<br> <<a href="mailto:a5dc5afdd2de45499d86573fe295a2cd@BLUPR04MB499.namprd04.prod.outlook.com">a5dc5afdd2de45499d86573fe295a2cd@BLUPR04MB499.namprd04.prod.outlook.com</a>><br> <br>Content-Type: text/plain; charset="iso-8859-1"<br><br>Hi,<br><br>A
few mechanical engineers have been asked, as part of their varied
workload, to author certain documents in English (How To, Webinars,
software essentials) in the near future.<br><br>Working with authors who
are not formally trained is a new experience for me. I am wondering how
to best define their tasks and the tasks of my technical writing group
who will work together to ensure quality documents. For example:<br><br><br>?
I could provide the engineers with templates in FrameMaker and
an introduction to the basics of technical writing and English grammar
and bring them to write good documents over time. Some formal training
in technical writing could be offered. The technical writers would then
review the final documents (container and content) to ensure the overall
quality of the documents.<br><br><br><br>? Or, maybe the role
of the engineers should be to write rough content within guidelines (get
the ideas and workflows on paper), and my team of technical writers
could be responsible for formatting the content and expressing their
ideas/workflows correctly in English. This would take much less time for
the engineer (less of a learning curve).<br><br>Do you have some experience in this matter? Any hints for what may work best?<br><br>Many thanks.<br><br>Here in Quebec City, Canada autumn is in full color. Mother Nature at her very best.<br><br><br>Stephen O'BRIEN<br>Coordonnateur ? la documentation et r?dacteur technique senior | Documentation Coordinator and Senior Technical Writer<br>InnovMetric Logiciels | Software<br><a href="mailto:sobrien@innovmetric.com">sobrien@innovmetric.com</a><mailto:<a href="mailto:sobrien@innovmetric.com">sobrien@innovmetric.com</a>><br>T (1) 418.688.2061<br>F (1) 418.688.3001<br><br><br>Stephen, engineers as authors, bad idea. I worked for about 20 years as a technical documentation consultant for the companies mostly doing business with the U.S. military. We would take the engineers notebooks, and any other write ups we could get, then do the circuit analysis and write the mil-spec technical manuals. On the other
hand, we didn't need language translators, only did translation from engineeringize to standard English. Ha. It simply wasn't feasible to teach the engineers tech writing to specs. They had to design the stuff, we had to translate it into theory of operation, and maintenance. That was why we got the big bucks.<br><div style="color:rgb(0, 0, 0);font-size:18px;font-family:arial, helvetica, clean, sans-serif;background-color:transparent;font-style:normal;"><font size="3">--<br>Keith Smyth<br>President<br>Smyth Consulting<br>------------------------------------------------------------------------------<span style="color:black;"><br></span><b><span class="yui_3_7_2_35_1381167424747_68" style="color:#4584a3;font-family:Arial, Helvetica, sans-serif;font-size:14px;"></span></b><span style="font-family:Arial, Helvetica, sans-serif;">"I’ve learned that people will forget what you said, people<br>will forget what you did, but people will never forget how<br>you
made them feel." <span style="font-weight:bold;">Maya Angelou</span></span><br>------------------------------------------------------------------------------<br>Technical Documentation Consultant</font></div><div><blockquote style="border-left: 2px solid rgb(16, 16, 255); margin-left: 5px; margin-top: 5px; padding-left: 5px;"> <div style="font-family: arial, helvetica, sans-serif; font-size: 12pt;"> <div style="font-family: times new roman, new york, times, serif; font-size: 12pt;"> <br> </div> </div> </blockquote></div> </div></body></html>