Guidance on error and warning messages for software used in radiotherapy
Introduction: This document is intended to be read by persons involved in software development for RADIOTHERAPY and provides guidance on how to write relevant error messages shown to the clinical OPERATORS. This document is meant to provide examples within the RADIOTHERAPY domain and is not meant to replace IEC/ISO standards governing usability (for example, IEC 62366-1:2015). With the advent of more RADIOTHERAPY equipment being computer controlled, there has been a reported increase in the number of treatment delivery errors, some serious, occurring due to misunderstanding of the various error and warning messages shown to the OPERATOR during usage. Mistakes in interpretation are more likely to occur when error messages are written in technical language or are presented to the user without an OPERATOR- friendly explanation. This problem is compounded by use of the following practices: message dialogs are designed from the program’s technical point of view and not from the clinical OPERATOR’S point of view; message dialogs are optimized for engineering purposes with little input from end USERS; insufficient attention and resources are given to applying good practices for usability of message dialogs and careful review by clinical representatives. In addition, the frequency of messages displayed by the many pieces of RADIOTHERAPY equipment to the OPERATOR can lead to "message overload". This increases the RISK that the OPERATOR will ignore critical information. This document provides guidan
Scope: This document, which is a Technical Report, provides guidance on the usage and form of error or warning messages written for software used in RADIOTHERAPY. It does not replace any requirements existing in the safety standards but is meant to be used as a supplement to existing standards on usability by providing specific examples in the field of RADIOTHERAPY. The two main goals of this document are 1) to present in a concise manner the best practices and design guidelines for good message dialogs, and 2) to illustrate these design guidelines with specific examples from the field of radiation oncology. This document is intended to be read by the following MANUFACTURERS’ employees and representatives: engineering department members including: software engineers, RISK managers, quality assurance engineers, technical writers, etc.; usability and human factors engineers; marketing representatives (product marketing, product managers, business analysts). Throughout this document, unless specifically called out, these guidelines apply to all categories of messages summarily called error or warning messages (e.g. critical error, warning, system status, informational, routine interlock messages).
Contents:
- FOREWORD
- INTRODUCTION
- Scope