It’s a scenario that everyone recognises, and not only in the Technical Editorial department: One reads a text, for example, an operating manual, and stumbles over scrambled letters. Maybe even in the title, as with this Blog. Such mistakes are only human and certainly happen to everyone, although they remain embarrassing. True to the motto "once doesn't count", one skims generously over one or even a few mistakes. However, when these mistakes pile up, they quickly distract from the content. In the worst case, one gives up and puts the text aside. This is especially alarming when the text, in our case the operating manual, contains important information that the reader should consider for his or her own safety, and for the optimal use of the product.
Software can Support Proofreading, but not Replace it
So that the flow of reading is not hindered by mistakes, comprehensive quality assurance always includes a check for linguistic correctness. There is automatic spellchecking, you say? Well, we all know the unintentionally weird examples of strange, nonsensical, or even incorrect "correction" suggestions made by the free-of-charge automatic spelling and grammar checks from the familiar Office applications. Even very powerful (fee-based) editing software can neither reliably check all error categories nor evaluate every mistake found in the sense of the author. It remains that even with good results through software-based testing, the most reliable tester is still human, namely the experienced editor.
Change the Perspective Often
In contrast to the software, an editor assists by taking different perspectives. With a view not only but especially on the technical documentation, he or she ist able to see from these perspectives, for example, mistakes in the following areas:
- The first things that surely comes to mind: spelling, grammar, and punctuation. The elimination of such mistakes is the classic proofreading that conjures up (perhaps not always fond) memories of school time and those red marks in the exercise book. To be absolutely solid in the regulations for these elementary disciplines is a prerequisite when working as
- In a narrower sense, the following also belong to linguistic error sources: syntax, expression, and style. These areas are a little bit more complex, because there is increasing demand for both language and style competence – not something that an official body of rules would contain. Stylistic requirements also differ according to the type of text. In technical documentation, an important style specification is, for example, the uniform formulation of the various functional units, such as work instructions. Such specifications are typically documented in an editorial guide. The editor must know these guidelines in detail and also have the competence to make a well-founded decision, even if the editorial guide does not make a statement on the issue at hand.
- Proofreading always overlaps with checking for factual correctness: Is the wording sufficiently precise? Are there textual redundancies or even contradictions? Does the text have a well-thought-out structure that supports the information reception? Often, an editor has too little specialist knowledge to be able to verify the text to be checked, by him or herself. However, he or she has sufficient textual competence to be able to identify any deficiencies in the content such as unclear wording or missing information that is necessary for understanding, etc. As one of the first readers, the editor can provide constructive criticism and give the author specific suggestions for revision.
- How important it is to have clear and consistent terminology in technical documentation has already been a subject in our Blog several times. In order to prevent errors from creeping in, despite toolsupported terminology management, the editor also checks whether the correct term is used for the correct part – and used in the correct place.
- There is no question that functional design supports text reception and comprehension. However, it is also generally accepted that errors can occur when formats are assigned to functional units. The result: Instead of making it easier for the reader to facilitate information, he or she may deliberately skip information if an incorrectly assigned functional unit differs from the reader‘s expectation regarding the content.This is especially the case with texts that serve as references and are often read only as excerpts – operating manuals, for example. During proofreading, it is also checked whether the formats introduced are being used consistently and correctly.
- A point which many may not be aware of right away: An editor doesn't just look at the text. Especially with instructional texts, technical illustrations are often used to support the text. Here, an editor checks the Text-Image Reference: Is the appropriate illustration being referred to? Are the position numbers and captions correct? Are the captions of the images well formulated?
Perhaps you're surprised after reading this list of how varied the tasks within proofreading are. This has its origin, not least because of the numerous formal requirements that technical documentation must fulfill. The more rules that must be observed, the higher the risk of error – whereby, it is better to speak of "violations" than "mistakes". For what may be desirable in other types of text (for example, the variation in wording), should not occur in so-called "controlled texts" such as operating manuals.
The Clever Combination of Human and Electronic Performance
Of course, an experienced editor doesn't analyse the mentioned aspects one after the other. To look at the same text critically several times from different perspectives would be highly inefficient.
It is unnecessary for two reasons: On one hand, professional Technical Editorial offices make use of the opportunities offered by special software such as Content Management Systems and terminology tools, not only during checking, but also during content creation. In this way, the frequency of errors can be reduced significantly. On the other hand, experience plays an important role in proofreading, especially when it comes to the time factor. In order to find all remaining mistakes during the final review (and in as few passes as possible), a high level of familiarity with the layout and the formats and graphic styles used is required – provided, of course, that one is familiar with all applicable rules and regulations, including the editorial guidelines. An experienced proofreader can thus identify different types of error simultaneously in a single pass.
A Practical Example
The smarty operating manual in our smart space (log-in required) demonstrates an example of what a proofread text looks like. No doubt about it: The procedures described in this brief excerpt would certainly be comprehensible, even without some of the corrections. The aim, however, should be to make it possible to absorb the information quickly, without misunderstandings and irritatingly turning pages back and forth, because one must ensure that one's own interpretation is correct. Such an optimised text leaves no questions unanswered in the subsequent translation process.
By the way, the use of handwritten correction is only one of several approaches. Depending on the editor in which the text was created, it is usually also possible to make corrections in electronic form.
All texts benefit from proofreading, be it technical documentation, a report, a technical article ... For the documents produced by us, proofreading is an integral part of quality control. However, we also offer our proofreading services as an independent service, which you can make use of for your own texts. If you suspect that the Error Gremlin has snuck in, please contact us!