Happy’s Essential Skills: Technical Writing
May 4, 2016 | Happy HoldenEstimated reading time: 8 minutes
Following is my process for technical writing—I hope that it will be useful to you. My process is the outgrowth of doing daily tasks. Generally, it follows these steps:
- Create a detailed outline of a topic.
- Make Powerpoint slides for a verbal presentation.
- Make the verbal presentation using your Powerpoint slides (this is important; you must actually speak the words).
- Using your outline and the Powerpoint slides, pick five to 12 slides that will become your figures in a written paper.
- Using the Powerpoint slides, begin writing a narrative, keeping the words you have already spoken in mind.
- If your slides contained bullets, data, etc., add tables and bullets until you come to one of the figures you have selected
- Add the figure(s) and continue until all your Powerpoint slides are consumed.
- Re-read what you have written, making sure that thoughts are complete and the subjects flow.
- You could record step 3 and play it back or use voice-to-text software for step 5.
Figure 5: Relationships and comments added to the mind map.
I have collected a series of technical papers or articles to create a three-hour technical course. Two or three technical courses can become a Chapter in a book. As you can see, I sneak up on technical writing; I cannot sit down and do it from scratch!
University of Michigan’s Technical Writing Guide
The Univ. of Michigan’s Technical Writing Guide is a comprehensive, 61-page instruction manual for technical writing. The five sections and eight appendices explain topics that range from general grammar and punctuation instructions, to incorporating lab reports, completing theoretical analyses, constructing reference sections and more. It’s a beginning-to-end guide that anyone attempting to generate a piece of technical writing should bookmark and refer to often.
MIT’s Technical Writing Process
Another useful reference is a compilation of lectures on technical writing by the MIT Writing Center. Following is a portion of an outline of 24 Powerpoint slides entitled, “Sentence Structure of Technical Writing,” written by Nicole Kelley.
1. Good Tech Writers Practice
a. Planning – before you begin
i. Know your audience and expectations
b. Clarity – avoid jargon and unfamiliar terms
i. Audience familiarity with the topic determines appropriate use of jargon and TLAs
c. Brevity – use words efficiently – never use two words when one word will do
i. Pare your language down to the essential message
ii. Place key information first in the main clause
iii. Remove redundancy by combining overlapping sentences
d. Simplicity – for clarity, balance details wisely with audience needs
i. Many engineers want to provide as much specific detail as possible, but this can come at the expense of reader understanding and your main point. Choose words with clear meanings
e. Good word choice – Avoid too many abstract nouns and unnecessary words.
i. Order the words in your sentences to avoid ambiguity
f. Active voice – an active voice is more straightforward and stronger than a passive voice
i. When in doubt, read passages out loud to determine the natural sound
g. Committing to writing as a process – good writing doesn’t happen overnight; it requires planning, drafting, rereading, revising, and editing
i. Learning and improving requires self-review, peer-review, subject-matter expert feedback, and practice
h. There are no shortcuts—practice makes perfect. Good writing is a habit that takes time to develop.
Good Advice
Regardless of the type of document that is being written, technical writing requires the writer to follow the practices of knowing his audience, writing in a clear, non-personal style, and doing extensive research on the topic. These practices enable the writer to create clear instructions and explanations.
- Know your audience. An expert in the field will understand certain abbreviations, acronyms, and lingo that directly applies to such a field. A novice will not understand in the same manner, and therefore, every detail must be explained.
- Omit opinions. Use an impersonal style. Write from a third person perspective, like a teacher instructing a student.
- Presentational strategies help the readers to grasp messages quickly.
Four points to keep in mind:
- The writing should be as straightforward as possible in order to ensure the reader understands the process or instruction. This may be simply a list of steps to achieving a desired goal, or a short or lengthy explanation of a concept or abstract idea.
- Know how to research for your intended audience. Gather information from a number of reliable sources, understand the information gathered so that it can be analyzed thoroughly, and then put the information into an easily digestible format to instruct those who read it. The more inexperienced your audience, the more information you will need to gather and explain.
- Be thorough in description and provide enough detail to make your points, but use an economy of words and avoid using gratuitous details.
- The top-down strategy (tell them what you will say, then say it)
- Headings (like headlines in newspapers)
- Chucks (short paragraphs)
- Plain, objective style so that readers can easily grasp details.
A good technical writer can make a difficult task easy and can quickly explain a complex piece of information.
Further Reading
The University of Michigan Technical Writing Guide includes a reference section with additional documents that you can download. This is true also of the MIT Technical Writing link provided above.
Conclusion
Are you ready to try your first technical paper? It’s not as difficult as you may think, and once started, can do your career a whole lot of good. Soon, IPC just issued a call for papers for next year’s APEX EXPO in San Diego. This is true also for the SMTA conference next fall in Chicago. Or, if you would like to submit a technical article for consideration in an I-Connect007 publication, contact Patty Goldman.
Page 2 of 2Suggested Items
I-Connect007 Editor’s Choice: Five Must-Reads for the Week
04/26/2024 | Andy Shaughnessy, Design007 MagazineIn this week’s roundup, we have a variety of articles covering everything from design through assembly, and even box build. I’ve always wondered whether box build was all it was cracked up to be. Do customers really pick one EMS provider over another because one company offers box build? And if you’ve ever wanted to volunteer, IPC’s Thought Leaders Program is looking for a few good technologists to help them on their mission. Check out Stanton Rak’s article, which was published in the spring issue of IPC Community.
Stan Rak: Elevating the Ideas and Insights of IPC's Thought Leaders Program
04/25/2024 | Stanton Rak, SF Rak CompanyAs a member of the IPC Thought Leaders Program (TLP), I am responsible for identifying knowledge-sharing opportunities that can generate ideas and insights that strengthen the IPC community as well as create a sustainable and lasting future for its members. I am delighted to highlight some of my recent contributions as a member of the TLP.
Alternative Manufacturing Inc. Awarded QML Requalification to IPC J-STD-001 and IPC-A-610
04/24/2024 | IPCIPC's Validation Services Program has awarded an IPC J-STD-001 and IPC-A-610 Qualified Manufacturers Listing (QML) requalification to Alternative Manufacturing Inc (AMI).
IPC Design Competition Champion Crowned at IPC APEX EXPO 2024
04/24/2024 | IPCAt IPC APEX EXPO 2024 in Anaheim, California, five competitors squared off to determine who was the best of the best at PCB design.
Big Win for Defense Production Act Budget Allocation in FY24 Budget
04/23/2024 | I-Connect007 Editorial TeamOne year ago, President Biden issued a determination that chips and packaging are critical for national security. Since that time, much work has been done to continue the conversation in Washington, elevating the importance of the entire chips value chain, and including printed circuit boards and substrates, without which chips cannot operate.