Technical Writing Tip of the Month - Key Elements of a Good Document
Technical Writing Tip - Key Elements of a Good Technical Document
Written by John Lafferty
Read Time: 2 minutes
A good document is one that gives a clear message which all of the intended readers can easily understand.
Key elements of a Technical Document:
The document must convey the most important message and direct the reader to any relevant detail. Remember, the most important message will be defined by the actions that you want the readers to take upon reading the document.
In order to readily convey the message to the reader, the document must contain a summary that is a microcosm of the document as a whole.
The introduction must explain why the reader is being asked to read the document.
The document should be self-explanatory i.e. the reader should be able to understand it without needing to read anything else.
The message should be conveyed using the minimum number of words; good use of graphics is essential for this.
The document should hold the readers attention and consistently meet their expectations without any surprises.
It almost goes without saying; that the document should be well structured, grammatically correct and free from typos.
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
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.
John Lafferty - Course Tutor
John Lafferty is Technical Writing Skills course tutor at SQT Training Ltd. He also delivers courses in areas such as Process Validation, Software Validation and Risk Management for Medical Devices. John runs a Quality Management Consultancy, Northridge Quality and Validation Services, specialising in the area of Medical Device and Pharmaceutical Quality Systems.