-
- News
- Books
Featured Books
- design007 Magazine
Latest Issues
Current IssueBreaking High-speed Material Constraints
Do you need specialty materials for your high-speed designs? Maybe not. Improvements in resins mean designers of high-speed boards can sometimes use traditional laminate systems. Learn more in this issue.
Level Up Your Design Skills
This month, our contributors discuss the PCB design classes available at IPC APEX EXPO 2024. As they explain, these courses cover everything from the basics of design through avoiding over-constraining high-speed boards, and so much more!
Opportunities and Challenges
In this issue, our expert contributors discuss the many opportunities and challenges in the PCB design community, and what can be done to grow the numbers of PCB designers—and design instructors.
- Articles
- Columns
Search Console
- Links
- Events
||| MENU - design007 Magazine
Happy’s Essential Skills: Technical Writing
May 4, 2016 | Happy HoldenEstimated reading time: 8 minutes
Technical writing is one of those topics that they don’t really talk about in college—at least not where I went. Writing and English has never been a strong like of mine compared to science and math. So I did my required time in English and wrote my lab reports the best I knew how. Even my senior projects and graduate reports were mostly graphs, tables, figures and drawings and the necessary information to explain what they were.
After taking my first job with Hewlett-Packard, it took me only a year to realize one startling fact: Only the bosses get to go to conferences! Junior engineers don’t get to go to conferences. But I wanted to learn more, meet other engineers in printed circuit manufacturing, see the latest equipment and listen to technical papers about my new field. Then I discovered the secret solution: If I presented a technical paper, the company was happy to send me to the conference.
I set out to write my first technical paper and discovered the process of technical writing and company legal reviews. I presented my first paper on our automated plating project at NEPCON in Anaheim in 1971. All went very well—and I decided that I would write a technical paper every other year. That went well for a while, but then I was writing a technical paper every year, then two or three a year for magazines, and soon marketing was asking me to write five or six each year, since I was writing a lot about HP hardware and software. This progressed over the next 40 years to columns, blogs, book chapters and eventually, an entire book.
Figure 1: General overview of technical writing applications.
Why is Technical Writing Important?
Technical writing consists of straightforward, easy to understand explanations and/or instructions dealing with a particular subject. It is an efficient and clear way of explaining something and how it works. An author writes about a particular subject that requires directions, instructions, or explanations. Technical writing has a very different purpose and is comprised of different characteristics than other types of writing, such as creative, academic or business.
The subject of technical writing can be one of two things:
- Tangible: Something that can be seen or touched (e.g., a computer or software program, or how to assemble a piece of furniture).
- Abstract: Something that involves a series of steps unrelated to a tangible object (e.g., steps required to complete a laboratory process).
Some examples of technical writing include:
- Technical papers
- Instruction manuals
- Policy manuals
- Memos
- Grants
- White papers
- Process manuals
- User manuals
- Reports of analysis
- Instructions for assembling a product
Writing Processes
I believe that it is always good to have a process, and technical writing is a perfect fit for that. Some of the problem solving processes discussed in previous installments of this series are useful, like the scientific method. But all processes start with an idea or even just a thought like, “What are you going to write about?”
Figure 2: General technical writing process.
Mind-Mapping
A mind map is defined by Wikipedia as “a diagram used to visually organize information. A mind map is often created around a single concept, drawn as an image in the center of a blank landscape page, to which associated representations of ideas such as images, words and parts of words are added. Major ideas are connected directly to the central concept, and other ideas branch out from those.” Figure 3 shows a typical Wikipedia mind map.
For any form of topic organization, I find that being able to see it arranged graphically is very helpful, and would strongly recommend the mind-mapping approach. It's also brilliant for taking notes at meetings—I've even projected notes while the meeting was taking place, so that everyone could see what they had said and its context!
This method is illustrated in Figures 4 and 5, in which a simple mind map is built on the topic of stencil printing variables. In the most complete version, some of the groupings and causal linkages have been drawn and appropriate notes have been added.
Figure 3: Wikipedia mind map of typical guidelines.
Figure 4: Stages in the evolution of mind-map notes.
Mind maps are considered to be a type of spider diagram. A similar concept is brainstorming. Brainstorming will be covered in an upcoming column.
Page 1 of 2
Suggested Items
I-Connect007 Editor’s Choice: Five Must-Reads for the Week
05/17/2024 | Andy Shaughnessy, Design007 MagazineThis week, trade shows are at the top of our feed, with our coverage of the Del Mar Electronics and Manufacturing Show and IPC APEX EXPO. These two longtime events are almost polar opposites in size and scope, but Del Mar seems to be expanding from its roots as a “neighborhood gathering” with its move into the Del Mar Fairgrounds. The Del Mar show always has a good “buzz factor,” which is something you can’t buy.
IPC APEX EXPO: Some Thoughts About Growth
05/16/2024 | Dan Feinberg, I-Connect007After two and a half days of wandering the aisles at IPC APEX EXPO 2024, for the first time, I almost felt like I was exploring CES. There were so many booths and exhibits that I could describe, but I’d like to focus on the growth and huge value of this event, which has expanded well beyond just the growing and impressive exhibit show floor.
IPC Raymond E. Pritchard Hall of Fame Award: Pierre-Jean Albrieux
05/10/2024 | Marcy LaRont, PCB007 MagazineCongratulations to Pierre-Jean Albrieux, who received the 2024 IPC Raymond E. Pritchard Hall of Fame Award. The award is given to individuals in recognition of the highest level of achievement, extraordinary contributions, and distinguished service to IPC and toward the advancement of the industry, including helping to create a spirit of mutual esteem, respect, and recognition among members consistent with the goals and mission of IPC.
IPC Focuses on Education and Onboarding
05/09/2024 | Andy Shaughnessy, Design007 MagazineI recently spoke with Carlos Plaza, senior director of education for IPC, about expanding educational efforts in the PCB design, fabrication, and assembly segments. As Carlos explains, PCB design is a hot topic, but onboarding may be the hottest one of all.
Real Time with… IPC APEX EXPO 2024: Industry Growth, Challenges, and Technological Advancements
05/09/2024 | Real Time with...IPC APEX EXPOEditor Nolan Johnson and Shawn DuBravac, IPC chief economist, dive into key industry topics such as growth, challenges, and technological advancements. They discuss shifts in the global competitive landscape, downstream demand, customization, and how AI is enhancing human skills. The industry outlook appears promising for both the short and long term.