Skip to content
PodSubs
ShowsPeopleGuestsJobsNewsEvents
More
BlogPodCred
Menu
ShowsPeopleGuestsJobsNewsEventsBlogPodCredNetworksSign in
Join nowSign in
  • Shows
  • People
  • Jobs
  • News
  • More
    • Guests
    • Events
    • Blog
    • PodCred
    • Networks
    Join nowSign in

Quality during Design

Quality during Design artwork

Crafting Effective Technical Documents for the Engineering Field

Jul 26, 202314 minAudio
ShareXLinkedInFacebookWhatsAppEmail

Ready to hone your technical writing skills as an engineer? This episode of the Quality During Design podcast is a must-listen! We delve into the critical role of technical communication in engineering, and why written communication skills are non-negotiable for engineers. Join me, Dianna Deeney, as we consider different perspectives to make your technical writing the best it can be. Our chat takes us on a journey through the past, present, and future of technical writing, as we root ourselves in the realities of presenting findings, interpreting data, and making actionable decisions. In the spirit of past, present, and future, we discuss techniques to ensure that your writing is effective and reaches your audience - be it your project team, auditors, or a future engineer referencing your work. Grab your pen and paper or open your word document as we together make strides in improving our technical communication skills. This Quality during Design Redux episode was originally "The Spirits of Technical Writing Past, Present, and Future". Visit the podcast blog, here. Send us a message Work with Dianna I provide independent quality engineering, product-assurance, and technical-risk support when product or process decisions need experienced outside scrutiny. My work includes: Quality-system and product-development method reviews Technical evidence and standards-based rationale Independent risk and readiness reviews Project-based and fractional quality advisory Start with a 20-minute conversation: https://calendly.com/dianna-deeney/discovery-call Interested in being a guest? If you have a practical perspective on quality, reliability, risk, or product development, email Dianna at dianna@qualityduringdesign.com. Pierce the Design Fog My book explains how cross-functional teams can align around customer needs, clarify design inputs, and make better product-development decisions. Read more: https://piercethedesignfog.com The book was an NIEA Finalist and was reviewed by PDMA. BookLife Reviews described it as: “Great for fans of Tony Fadell’s Build, David H. DeWolf and Jessica S. Hall’s The Product Mindset.” Free resources for subscribers Subscribe to the Quality during Design digest for monthly practical highlights, plus access to the Strategic Quality Integration Checklist ...

Audio and video play straight from the show's own hosting. PodSubs stores and serves no media.

Transcript

From the show. Tap a time to play from there.

Dianna DeeneyHi, it's Dianna Deeney. I want to take the next few episodes of the Quality During Design podcast and talk about technical communication. I know as an engineer, we like to tinker, fix things, build things, work on the benches, be out on the floor doing things, but a big part of our job is also communicating to others and that includes writing, writing protocols, writing reports. It's actually a very important part of an engineering career being able to write and communicate with others.

Dianna DeeneyNext week in the podcast, we're going to have a special episode part of the A Chat with Cross Functional Experts series and we'll be interviewing a technical communication expert. Technical writers, technical communicators, are part of our cross functional team. They're partners in product design and delivering the final product to the end user. To get us warmed up to technical writing and technical communication, I'm pulling an episode from the archive about technical writing: how we as engineers are responsible for writing stuff and the different viewpoints that we can take to make our technical writing the best that we could possibly make it.

Dianna DeeneySo get out your pens and pencils or flip open your Word document or Google Docs document, whatever you use. Please take this episode to start thinking about technical writing and technical communication, how you approach it and how you do it, and then we'll have our interview with an expert. So here is the redux episode, the Spirits of Technical Writing Past, Present and Future.

Dianna DeeneyWe all know a part of engineering is actually writing up our results. Some of us like to do it and some of us really just don't like to do it, but it's a necessary thing because it's a mode of communication A mode of communication for a lot of people, for different reasons. We may be writing technical reports about the results that we got and coming to a conclusion about our decision about the test results. What are we going to do next?

Dianna DeeneyWe may be writing protocols for test procedures in order to get those results and we need to communicate that protocol for other people to independently run the test and do it well. And then there's things that can happen the root cause, analyses of failures that happened during tests. All of these kind of writings are things that engineers need to do. It doesn't always make sense to pass it off to a technical writer. When we're writing these are, are they getting kicked back to us by the reviewers to add more detail, or are we feeling like it's a little bit fruitless because we don't feel like the reviewers are actually reading it.

Dianna DeeneyThey're not giving us any feedback at all. How do we know when our piece of technical writing is complete? I have a trick for you that I use all the time, and it has to do with ghosts. Let's talk more about it after the brief introduction. Hello and welcome to quality during design, the place to use quality thinking to create products others love for less. Each week, we talk about ways to use quality during design, engineering and product development.

Dianna DeeneyMy name is Dianna Deeney. I'm a senior level quality professional and Engineer with over 20 years of experience in manufacturing and design. Listen in and then join us. Visit quality during design comm. Do you know what 12 things you should have before a design concept makes it to the engineering drawing board where your settings specifications? I've got a free checklist for you and you can do some assessments of your own. Where do you stack up with the checklist?

Dianna DeeneyYou can log into a learning portal to access the checklist and an introduction to more information About how to get those 12 things. To get this free information, just sign up at quality during design comm on the home page. There's a link in the middle of the page. Just click it and say I want it. Technical writing it is a skill that needs to be learned. I remember early on in my engineering career I had saved my technical writing textbook from College and it was really useful.

Dianna DeeneyIt takes practice and thankfully, engineers get lots of opportunities to practice their technical writing. Our companies probably have templates and forms that we have to fill out and That can be helpful for the company. Everything is in the similar format in the same place. I used to be a little annoyed at that, but as I've grown to be a more mature engineer, i understand the purpose of it to make sure that all the information is captured.

Dianna DeeneyIt's easier for the reviewers when they're looking for information in a particular spot. As a quality engineer, i was an independent reviewer on a lot of other people's technical reports And there were certain things that I looked for, regardless of whether a template was used or not. There's a practicality to it. Also, you're working with somebody else to capture the information that we think we might need. There's a simple guideline that I use to be able to help me with technical writing and in the technical writing of others that I review, and it really has to do with the audience any writing that we do, we want to think of the audience.

Dianna DeeneyWell, when we're writing these technical reports, who is the audience? the people reviewing it? Not necessarily. We have to think a little bit bigger than that. We have to think of the ghosts of technical writing, past, present and future. I'm sure you're at least aware of Charles Dickens' novel a Christmas Carol. He wrote it in 1843. It's the story of Ebenezer Scrooge and he's an old guy who is Miserly.

Dianna DeeneyHe he likes his money, he doesn't want to share it and he is visited by Forkos, his former business partner. But then also the spirits of Christmas past, present and future, or yet to come. We can steal from Charles Dickens's idea to think about the audience that we're writing for. When we're doing our technical writing pieces, our audience are the people who are reading it now for approval, or are reading it tomorrow after it's published.

Dianna DeeneyIt's also written to the future and we can think of where we've been in the past. Taking these different viewpoints of our audience with our technical writing will make sure that it's the best it can be. And it's simple. Let's talk about the spirit of writing to the present. We do want to write our technical pieces for who is reading it now, which is probably our project team or our cross-functional team.

Dianna DeeneyThey are making decisions about what to do with the project based on what they're reading in the technical report. Also, if we're in a regulated industry, we may be writing for auditors Third-party, independent people that are coming in to ensure that we're doing what we say that we're doing and that we're complying with regulations. They look for evidence of that in the reports that we write and they may come across ours. So I would consider those kind of reviews also within the realm of writing for the present.

Dianna DeeneyIn writing for the present, people need to have enough information about what we've done, captured in the report, so they understand what we've done and can decide if they agree with a conclusion, need to see more tests or a different analysis and then make a decision. Now, in the spirit of writing to the future, we want to think of another engineer, maybe even 10 years from the time that we're writing a report.

Dianna DeeneyThey have the same technical knowledge as we do. We want to write our technical writings so that they can duplicate our results or understand the conclusion that we made and how we got there. This is really clear if we think about a test report and a test protocol. Another engineer, 10 years from now, will be able to pick up our report, gather the same equipment, perform the same test and get the same results. And that's without us being there, because by then maybe we're working on some other super-duper project somewhere else.

Dianna DeeneyIn this sense, we're creating technical writings that are independent for themselves. Now, that's not to say you have to include the whole world in your one document, make references to other documents, as long as that future engineer will be able to pull all the pieces together and recreate what we did. That's a good check for a technical writing piece And the last check for our technical writing to see if it's complete. We can write to the spirit of our past selves.

Dianna DeeneyWhen we're in the midst of a project. We've got our fingers on the pulse of everything that is going on with the project. We know what the other engineers are doing, we know what manufacturing is developing. We understand how all the puzzle pieces are fitting together. However, in the spirit of writing to the past, our past selves, before we got involved in the project, didn't know anything about what was going on and what we were trying to accomplish. So when we're doing our technical writing.

Dianna DeeneyCan our past selves from six months ago understand what's going on and what we're trying to accomplish With any given project? there are lots of reports and technical writings and there's honestly a lot going on right. A lot of different people are producing different reports. In the end, we'll have a dossier in the general meeting, a collection of files about the project that tells the story of how it was developed, what was learned along the product development cycle, the decisions that were made and, ultimately, how we got to producing and releasing the product to market.

Dianna DeeneyThe term dossier is used at least in medical device manufacturers, but I mean it more in the general sense of a dossier, even if you're not working in a regulated industry. Having this dossier, this collection of documents, will help other new product development teams in the future to kick off their project. We're not starting from zero anymore. We've learned a lot in developing this one product. We can use what we've learned to develop other products and we have a record of what we've learned in the dossier and in our technical writings.

Dianna DeeneyIf we're having field failures or the performance has changed over time, what has changed about its use? environment versus how we tested it Maybe we didn't test it to the environment that it's being used in. Having the dossier would be able to tell us that information and help us get to the root cause of the problem When we're working on future projects. Even if we didn't use what we did in the past to start the new one, we'll have some memory or understanding.

Dianna DeeneyHey, didn't our other product do this too? Didn't we see these kind of results, and what happened there? We'd be able to look back at the report and find out why. These are all ways that we might be able to use our technical writing to help us in the future. What's today's insight to action? Engineers need to write stuff down. It's part of the job description and part of our responsibilities to do With any writing. We want to think of the audience, but we can expand that to ensure that our technical writing is the best that it can be.

Dianna DeeneyWe can write in the spirit of the past, present and future. We can use these spirits as we're writing and we can also run our final drafts through the filters of these spirits, and that will definitely help us communicate our technical expertise to others. If you like this topic or the content in this episode, there's much more on our website including information about how to join our signature coaching program.

Dianna DeeneyThe quality during design journey. Consistency is important, so subscribe to the weekly newsletter. This has been a production of Deeney Enterprises. Thanks for listening.

Open the transcript file

Hosts and Guests

Nobody is credited on this episode yet.

Credit the people on this episode

Be the first to rate this episode

More episodes

All episodes
  1. Why We Jump: Fear

    Nov 12, 202613 minAudio

    Fear is one reason teams jump from an idea to a solution before they understand the problem. It does not always look like panic. It can look like adding another inspection, building a feature that can be placed on a...

    Credit the people on this episode

  2. Customer Discovery Across Product Stages, with Ashley Phillips

    Oct 22, 202640 minAudio

    Ashley Phillips joins Dianna to discuss how customer discovery changes across startups, hypergrowth teams, and established products. Customers may surprise a team with new ways to use a product, while the environment...

    Credit the people on this episode

  3. Two Ways We Jump: Speed and Certainty

    Oct 8, 202610 minAudio

    In this solo episode of Quality during Design, Dianna looks at two reasons product development teams jump from a partial understanding of a problem to a committed solution: speed and certainty. Fast prototyping,...

    Credit the people on this episode

  4. When Building Gets Cheap, Decisions Matter More, with Ashley Roach

    Sep 24, 202637 minAudio

    Fast prototyping changes the constraint. When software, AI tools, and other rapid-prototyping methods make it inexpensive to turn an idea into something testable, the challenge is no longer only Can we build it? The...

    Credit the people on this episode

  5. Why Do We Jump? About the Moment Before We Commit

    Sep 10, 20267 minAudio

    When a project goes off track, we usually look back and say, “We didn’t define the problem, and we jumped.” That sounds like a process breakdown, as if one good checklist or gate approval would have prevented it. But...

    Credit the people on this episode