Know your audience

Engineers are competent technical professionals, but when it comes to adding notes to a drawing or writing a design report, language may not always come naturally to some.


Knowing your audience is the key to successful writing. For engineers, documents are typically drafted to be understood by the contractor, the owner, and sometimes the judicial system. These three audiences may each have different levels of education, ranging from high or trade school to graduate level degrees or higher. You should also presume that some percentage of your audience may not be literate or have limited command of the English language. However, all parties need to arrive at the same conclusion when interpreting the drawings and specifications.


Drawings alleviate much of the engineer's communication burden as graphical depictions leave very little room for subjective interpretations. But drawings can only communicate so much. What about the quality requirements of the items depicted? How do you articulate to the client the decisions made during design?


Additionally, there is another factor in this equation. When working in an office setting, you know how to communicate with your manager and team members. You are all in the same work environment every day and likely share similar education and work experience. After the initial acclimation period, you know how to communicate: whom to address in a particular situation, those who need the long explanation, and those who are satisfied with a brief summary.


When preparing engineering documents, you don't know the audience personally or have an idea of the organization's culture or procedures, and you can't make more than a guess at their education level. That makes any sort of writing difficult.


It's no magic bullet, and there are likely other ways to do it, but here is one way I've found to be effective when writing specifications, design reports, and other engineering documents: Write for the judge.


In the absolute worst-case scenario, a highly educated person with little to no technical background is reviewing your contract documents and will make a decision based upon his or her interpretation of those documents. The judge may not know the difference between single phase or three phase electricity or a tack coat and a finish coat, but their understanding of your documents will result in a legally binding opinion.


The chance that your engineering documents will be involved in litigation may be slim, but it is rising. According to the Fulbright 9th Annual Litigation Trends Survey, 80% of the engineering and construction companies surveyed were involved in litigation, with 57% of the surveyed engineering and construction companies annually spending $5 million or more on litigation fees (pg. 19). Twenty percent of the engineering and construction companies surveyed have more than $20 million at stake (pg. 14). Engineering and construction companies also had the highest anticipation of more litigation – 31% of engineering and construction companies forecast more arbitration and higher legal fees for 2013 (pg. 9). The American Bar Association even has a Construction Litigation Committee – you get the idea. Note that fees don't cover settlements or judgments, so the total cost may be significantly higher.


Getting back to writing, to many, writing for a judge instead of a contractor goes against the grain. But think about it for a moment. As engineers, we are tasked with preparing construction documents that become legal documents upon signing and sealing or submitting them per the client's requirements. Once those documents enter the judicial system, there is no requirement for those involved in litigation to have specialized training, experience, or background in the subject matter of the documents. Sure, some lawyers may have a degree from an engineering school or a professional engineer license, but they also may have neither.


A judge or lawyer is skilled at picking apart documents to find inconsistencies, conflicts, and holes. It would not be difficult to see that the description of a system in a specification does not match what is shown on the drawings, or to notice that the design report scrupulously describes certain parts of the work but completely ignores other elements. This isn't anything different than what a contractor looks for in a bidding situation.


It is your job to describe the system(s), assemblies, and desired performance in language that is able to be interpreted by all parties in the same manner. This doesn't mean the documents should be "dumbed down" or simplistically written. The documents should use appropriate terminology and be written in a manner that clearly, concisely, correctly, and completely (we'll discuss the 4 C's another time) addresses the work. The documents should also be consistent in their language, presentation, and style.


Ultimately, if a judge, who is well versed in learning about and assessing a situation, is able to understand your documents with minimum outside help, not only have you succeeded in presenting your case well, but the likelihood of a contractor reaching the same conclusion is very good.


I'll present some examples in future entries. In the meantime, there is a wealth of resources available for engineers who want to work on their writing. Taking courses in engineering law or technical writing are an excellent way to meet continuing education requirements. Professional societies such as ASME, IEEE, and ASCE all have resources on writing for engineers.


Feel free to add resources or share your experience writing as an engineer below.

Michael Heinsdorf, PE, LEED AP, CDT is an Engineering Specification Writer at ARCOMMasterSpec. He has more than 10 years' experience in consulting engineering, and is the lead author of MasterSpec Electrical, Communications, and Electronic Safety and Security guide specifications. He holds a BSEE from Drexel University and is currently pursuing a Masters in Engineering Management, also at Drexel University.

No comments
The Engineers' Choice Awards highlight some of the best new control, instrumentation and automation products as chosen by...
The System Integrator Giants program lists the top 100 system integrators among companies listed in CFE Media's Global System Integrator Database.
Each year, a panel of Control Engineering and Plant Engineering editors and industry expert judges select the System Integrator of the Year Award winners in three categories.
This eGuide illustrates solutions, applications and benefits of machine vision systems.
Learn how to increase device reliability in harsh environments and decrease unplanned system downtime.
This eGuide contains a series of articles and videos that considers theoretical and practical; immediate needs and a look into the future.
Controller programming; Safety networks; Enclosure design; Power quality; Safety integrity levels; Increasing process efficiency
Additive manufacturing benefits; HMI and sensor tips; System integrator advice; Innovations from the industry
Robotic safety, collaboration, standards; DCS migration tips; IT/OT convergence; 2017 Control Engineering Salary and Career Survey
Featured articles highlight technologies that enable the Industrial Internet of Things, IIoT-related products and strategies to get data more easily to the user.
This article collection contains several articles on how automation and controls are helping human-machine interface (HMI) hardware and software advance.
This digital report will explore several aspects of how IIoT will transform manufacturing in the coming years.

Find and connect with the most suitable service provider for your unique application. Start searching the Global System Integrator Database Now!

Infrastructure for natural gas expansion; Artificial lift methods; Disruptive technology and fugitive gas emissions
Mobility as the means to offshore innovation; Preventing another Deepwater Horizon; ROVs as subsea robots; SCADA and the radio spectrum
Future of oil and gas projects; Reservoir models; The importance of SCADA to oil and gas
Automation Engineer; Wood Group
System Integrator; Cross Integrated Systems Group
Jose S. Vasquez, Jr.
Fire & Life Safety Engineer; Technip USA Inc.
This course focuses on climate analysis, appropriateness of cooling system selection, and combining cooling systems.
This course will help identify and reveal electrical hazards and identify the solutions to implementing and maintaining a safe work environment.
This course explains how maintaining power and communication systems through emergency power-generation systems is critical.
click me