Northridge Management Services

Contact Us



Services
    Software Validation

    Process Validation

    Risk Management

    Quality Systems

    Process Improvement

    Training

    Technical Writing

    Interim Management

    Auditing
Blog
Technical Writing Tip of the Month - The Description
8th April 2021

What is the difference between the EN and ISO versions of 14971:2019? Part 1
14th September 2020

What is the difference between the EN and ISO versions of 14971:2019? Part 2
14th September 2020

more...


Technical Writing Tip of the Month - The Description

Technical Writing Skills Tip - The Description

 

Written by John Lafferty

Read time: 2 minutes

The Description in a Technical Report


The majority of technical reports include some type of description, either of objects, processes or ideas. A description can be physical, functional or both. Good descriptions are crucial to creating good documents and they should utilise the Outside-In approach, a technique discussed in a previous blog (January 2018)

1. Consider the technical level of the intended reader 
2. Begin with the name of the object followed by its definition. 
3. Include a labelled diagram or photograph. 
4. Describe the most obvious details first and then go on to specific details. 
5. Sequence the details of the descriptions to make the picture complete and understandable. 
6. Describe how things work and how to perform certain actions. 
7. Identify process steps and human interaction. 
8. Explain how things look before, during, or after the process. 
9. Provide examples of what you are explaining. 
10. Compare the process to something familiar to help readers understand. 
11. Check, with the device in front of you, for completeness, logical order; and word choice. 
12. Anticipate questions 
13. Avoid abstract words such as pretty, really or very. 
14. Use precise, concrete adjectives or terms such as parallel, smooth, one metre high. 
15. Define any technical terms.

Technical Writing Skills Training Course 

Northridge Quality & Validation and our training partners, SQT Training are running a comprehensive training course on Technical Writing Skills. Note: This course will be delivered via a Virtual Classroom (not in person). 

Course Title: Technical Writing Skills 

Course Date and Booking: The next course will be delivered by Virtual Classroom delivery on 24th June 2020 so that you can attend without leaving your home or office. Course booking and future course dates can be found on the SQT Training website. 

Course Content: Our structured, practical programme will help you to identify the key message you need to deliver in your written document and to deliver it clearly and concisely in a way that will ensure it is understood.

About the Author - John Lafferty



John Lafferty is the Technical Writing Skills course tutor at SQT Training Ltd. John also delivers courses in Quality Systems, Process Validation, Software Validation and Quality Risk Management on behalf of SQT. John runs a highly successful Quality Management Consultancy, Northridge Quality & Validation, which specialises in assisting companies in the Life Sciences manufacturing sector.



Comments:


Post A Comment:

Name:
Email:
Comment:*




 

    Home - Services - Clients - News - About Us - Contact Us