{"id":1788,"date":"2022-12-01T07:31:00","date_gmt":"2022-12-01T06:31:00","guid":{"rendered":"https:\/\/staging.lexsys.de\/grundlagen-der-technischen-dokumentation-fuer-einsteiger\/"},"modified":"2024-09-23T10:07:55","modified_gmt":"2024-09-23T08:07:55","slug":"technical-documentation-101","status":"publish","type":"post","link":"https:\/\/lexsys.de\/en\/technical-documentation-101\/","title":{"rendered":"Technical Documentation 101"},"content":{"rendered":"\n<p><br>When dealing with the topic of&nbsp;<strong>technical documentation&nbsp;<\/strong>for the first time, start-ups and other companies can quickly start to feel overwhelmed. This often leads to many questions, such as:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>What exactly is technical documentation?<\/li>\n\n\n\n<li>Why do we differentiate between internal and external documentation?<\/li>\n\n\n\n<li>Why do you need to take various target audiences into account?<\/li>\n\n\n\n<li>What legal requirements and standards are there to consider?<\/li>\n\n\n\n<li>What does a technical writer actually do?<\/li>\n\n\n\n<li>What tools do you need?<\/li>\n\n\n\n<li>And how can you get your technical documentation translated?<\/li>\n<\/ul>\n\n\n\n<p>In our latest blog, we\u2019ll provide easily understandable answers to these questions and more.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>What is technical documentation?<\/strong><\/h2>\n\n\n\n<p><a href=\"https:\/\/en.wikipedia.org\/wiki\/Technical_documentation\" target=\"_blank\" rel=\"noreferrer noopener\">Technical documentation<\/a>&nbsp;(TD, also known as \u201cproduct documentation\u201d) comprises all types of documents relating to technical devices and software products. Whether online or on paper, they describe how to safely use, maintain, and\/or repair such equipment.<\/p>\n\n\n\n<p>Technical documentation is always designed for a particular purpose. In basic terms, it\u2019s meant to enable the respective target audience \u2013 be it users, technicians, or sales engineers \u2013 to do what they need to do. It also gives manufacturers a means of protecting themselves from liability claims and fulfilling all their legal obligations.<\/p>\n\n\n\n<p>As a general rule, we distinguish between internal and external technical documentation:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Internal technical documentation\u00a0<\/strong>provides an archive of all product-relevant documents. Such documents include specification sheets, test reports, risk assessments, and blueprints.<\/li>\n\n\n\n<li><strong>External technical documentation<\/strong>, on the other hand, tells operators and users how to do things like assemble, install, use, and maintain a given product.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Who is the technical documentation for?&nbsp;<\/strong><\/h2>\n\n\n\n<p>This is the most important question manufacturers have to answer before writing their TD: Who is our target audience? Instead of compiling a 400-page tome that addresses absolutely everyone\u2019s needs, it\u2019s best to create a separate document for each group.<\/p>\n\n\n\n<p>Before you get started, think about what actions are required throughout the lifecycle of the product and who will be responsible for them. Put together a brief overview of all this information. Here\u2019s what this might look like based on the example of a CNC lathe machine:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Planning: people affiliated with the manufacturer<\/li>\n\n\n\n<li>Transport: shipping company<\/li>\n\n\n\n<li>Installation: people affiliated with the manufacturer<\/li>\n\n\n\n<li>Programming: CNC cutting specialist, programmer<\/li>\n\n\n\n<li>Use: CNC cutting specialist<\/li>\n\n\n\n<li>Maintenance: CNC cutting specialist<\/li>\n\n\n\n<li>Repairs: CNC cutting specialist, service technician<\/li>\n\n\n\n<li>Disassembly&#8230;<\/li>\n<\/ul>\n\n\n\n<p>In this setting (which Dietrich Juhl describes in the book&nbsp;<em>Technische Dokumentation<\/em><sup>*1<\/sup>), the CNC cutting specialist doesn\u2019t need to know how the machine is transported or installed. What is relevant, however, are the instructions on programming, use, and maintenance.<\/p>\n\n\n\n<p>According to Juhl, there should thus be eight different manuals for the CNC machine\u2019s various target groups:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Planning documentation<\/li>\n\n\n\n<li>Transport instructions<\/li>\n\n\n\n<li>Installation and commissioning instructions<\/li>\n\n\n\n<li>Operating instructions<\/li>\n\n\n\n<li>Programming manual<\/li>\n\n\n\n<li>Three sets of service documentation (mechanical, hydraulic, electrical)<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>What norms and legal requirements do you need to observe?<\/strong><\/h2>\n\n\n\n<p>The people in charge of writing laws are known to be rather particular about safety. Products therefore need to be designed accordingly and present no danger to people\u2019s well-being. In cases where risks can\u2019t be ruled out entirely, manufacturers are required to provide relevant warnings and notices.<\/p>\n\n\n\n<p>This is why technical documentation is subject to a wide range of norms and legal requirements, a selection of which follows:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>DIN EN 82079-1\u00a0<\/strong>is a norm for the creation of usage instructions. Among other things, it covers communication quality, risk mitigation, and the form and content of user manuals. It also includes free checklists that help ensure corresponding compliance. This norm should be part of any technical writer\u2019s basic toolkit.<\/li>\n\n\n\n<li><strong>EU Directive 2006\/42\/EC (the \u201cMachinery Directive\u201d)\u00a0<\/strong>requires manufacturers to provide operating instructions in their own language (and others, if applicable) that take users\u2019 level of knowledge and comprehension ability into account.<\/li>\n\n\n\n<li>The<strong>\u00a0VDI 4500 standard\u00a0<\/strong>covers various aspects of technical documentation, from terminology, organisation, and administration to the planning, design, and creation of actual documents.<\/li>\n\n\n\n<li>The\u00a0<strong>DIN EN ISO 7010<\/strong>\u00a0norm presents a uniform standard for safety signs that eschews text in favour of language-independent, universally understandable signage.<\/li>\n\n\n\n<li><strong>ANSI Z535<\/strong>\u00a0is the US norm for safety information. While it isn\u2019t relevant for products brought to market in Europe, it is of interest to manufacturers that export machines and other devices to the United States.<\/li>\n\n\n\n<li>Other countries may have other regulations, such as Germany\u2019s legislation on product safety (<strong>ProdSG<\/strong>), which represents the country\u2019s implementation of EU Directive 2001\/95\/EC.<\/li>\n<\/ul>\n\n\n\n<p>In addition, further regulations apply to different product groups and regions, such as the German legislation on medical products (<strong>MPG<\/strong>) or&nbsp;<strong>EU Directive 2006\/95\/EC<\/strong>&nbsp;(regarding low-voltage electrical equipment).<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>What role do technical writers play?<\/strong><\/h2>\n\n\n\n<p>You might think that creating technical documentation is another task handled by engineers themselves, but it\u2019s actually the job of&nbsp;<strong>technical writers<\/strong>. These specialists have the ability to explain complex functions and situations in ways that are easy for the respective target group to understand. They often have a direct line to the manufacturer\u2019s development team, as well.<\/p>\n\n\n\n<p>That said, technical documentation is obviously not the same as ad copy or other marketing materials: writing product descriptions, glossy brochures, and flyers that drive sales requires additional skills.<\/p>\n\n\n\n<p>Technical writers who are also well versed in creating copy can handle both areas. Those who aren\u2019t, can work with copywriters on such projects:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>The\u00a0<strong>technical writer\u00a0<\/strong>ensures that all the technical facts provided are correct.<\/li>\n\n\n\n<li>The\u00a0<strong>copywriter\u00a0<\/strong>comes up with attractive texts that encourage readers to make a purchase. \u00a0<\/li>\n<\/ul>\n\n\n\n<p>To learn more about the benefits of having technical writers and copywriters collaborate, check out the article&nbsp;<a href=\"https:\/\/lexsys.de\/en\/blog\/how-technical-writers-fit-into-the-marketing-mix\" target=\"_blank\" rel=\"noreferrer noopener\">How Technical Writers Fit into the Marketing Mix<\/a>.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>What software and tools do you need for your technical documentation?<\/strong><\/h2>\n\n\n\n<p>Managing all your technical documentation can present another challenge. Manufacturers need to document in detail every functional change in their products and ensure that all their external documentation is updated accordingly. This is why Lexsys advises against managing technical documentation in Microsoft Word or other word-processing programs.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>How suitable are component content management systems for technical documentation?<\/strong><\/h2>\n\n\n\n<p>In recent years, content management systems (CMS) have gained popularity as a means of simplifying the creation, maintenance, and publication of TD. Even more interesting for product manufacturers, however, are&nbsp;<strong>component content management systems (CCMS)<\/strong>, which are capable of storing not just documents, but individual pieces of information, as well.<\/p>\n\n\n\n<p>These \u201ccomponents\u201d can include diagrams, charts, product descriptions, or processes. They can also be as small as a single word or as extensive as an entire document.<\/p>\n\n\n\n<p>At the heart of such systems are various document formats \u2013&nbsp;<a href=\"https:\/\/en.wikipedia.org\/wiki\/Darwin_Information_Typing_Architecture\" target=\"_blank\" rel=\"noreferrer noopener\">DITA<\/a>, for example, an XML-based architecture for creating, distributing, and reusing technical information.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>How can you translate technical documentation?<\/strong><\/h2>\n\n\n\n<p>Companies that want to sell their products abroad need to have their technical documentation adapted for each target country. According to the German technical communication society&nbsp;<a href=\"https:\/\/www.tekom.de\/technische-kommunikation-das-berufsfeld\/kompetenzrahmen-fuer-die-technische-uebersetzung\" target=\"_blank\" rel=\"noreferrer noopener\">tekom<\/a>&nbsp;(link in German), nearly half of all technical documents are translated into more than 10 languages.<\/p>\n\n\n\n<p>These days, there are very few manufacturers left that have their own translators and localisation teams, which is why many of them assign such work to external translation agencies. The best agencies offer manufacturers an array of advantages because they:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Handle all aspects of project management<\/li>\n\n\n\n<li>Work with a pool of highly qualified technical translators<\/li>\n\n\n\n<li>Offer excellent quality assurance based on ISO certification<\/li>\n\n\n\n<li>Possess industry-specific expertise<\/li>\n<\/ul>\n\n\n\n<p>A professional translation agency can advise manufacturers on all matters related to the&nbsp;<a href=\"https:\/\/lexsys.de\/en\/blog\/tips-on-creating-and-translating-technical-documentation\" target=\"_blank\" rel=\"noreferrer noopener\">translation of technical documentation<\/a>, including the pros and cons of&nbsp;<a href=\"https:\/\/lexsys.de\/en\/blog\/machine-translation-can-a-computer-get-your-message-across-effectively\" target=\"_blank\" rel=\"noreferrer noopener\">machine translation<\/a>&nbsp;and&nbsp;<a href=\"https:\/\/lexsys.de\/en\/blog\/machine-translation-post-editing\" target=\"_blank\" rel=\"noreferrer noopener\">related post-editing<\/a>&nbsp;\u2013 that is, having human experts review machine-translated texts.<\/p>\n\n\n\n<p>Since the translation market is unregulated and somewhat cluttered, manufacturers should take a close look at several different providers before choosing the one they want to&nbsp;<strong>entrust with their technical documentation<\/strong>.<\/p>\n\n\n\n<p>Here are some examples of criteria you should focus on:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>ISO 9001 certification (quality management)<\/li>\n\n\n\n<li>Positive customer feedback<\/li>\n\n\n\n<li>Transparent processes and prices<\/li>\n\n\n\n<li>Professional translators who work in their native language<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Where can you find useful resources on this subject?<\/strong><\/h2>\n\n\n\n<p>If you want to find out more about technical documentation, further helpful information is available here:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><a href=\"https:\/\/www.vdi.de\/en\/home\" target=\"_blank\" rel=\"noreferrer noopener\">VDI standards<\/a>: Access publications on the various standards issued by the Association of German Engineers (VDI).<\/li>\n\n\n\n<li><a href=\"https:\/\/www.tekom.de\/\" target=\"_blank\" rel=\"noreferrer noopener\">tekom<\/a>: The website of the world\u2019s largest professional association for technical information offers information (in German) on specialist conventions, industry events, further training opportunities, and much more.<\/li>\n\n\n\n<li><strong><em><sup>1<\/sup>Technische Dokumentation: Praktische Anleitungen und Beispiele<\/em><\/strong>\u00a0by Dietrich Juhl, Springer Vieweg, 2015. Written primarily for technical writers, this guide provides many useful tips on creating various types of instructions.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Lexsys: the partner you can rely on for flawless technical documentation&nbsp;<\/strong><\/h2>\n\n\n\n<p>The world of technical documentation can seem daunting for manufacturers of software and devices. The requirements they face include:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Ensuring compliance with legal specifications and norms<\/li>\n\n\n\n<li>Taking various target groups into account<\/li>\n\n\n\n<li>Finding a technical writer to create their documentation<\/li>\n\n\n\n<li>Managing, maintaining, and publishing this content<\/li>\n\n\n\n<li>Having the documentation translated, if applicable<\/li>\n<\/ul>\n\n\n\n<p>Ticking all these boxes \u2013 and doing it well \u2013 is no easy task. At Lexsys, we\u2019ve spent years helping manufacturers pull it off and would be happy to guide you through all the issues related to technical communication, from the costs and software involved to the actual creation and translation of your documentation.<\/p>\n\n\n\n<p>Do you need support with your technical documentation?\u00a0<a href=\"\/en\/contact\/\" target=\"_blank\" data-type=\"page\" data-id=\"1376\" rel=\"noreferrer noopener\">Contact us today<\/a>\u00a0to set up a consultation.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Do you know the importance of technical documentation for startups? Find out why it&#8217;s crucial for your company&#8217;s success in our latest blog post!<\/p>\n","protected":false},"author":5,"featured_media":1821,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[28],"tags":[36],"class_list":["post-1788","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-information-design-en","tag-technical-documentation"],"_links":{"self":[{"href":"https:\/\/lexsys.de\/en\/wp-json\/wp\/v2\/posts\/1788","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lexsys.de\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lexsys.de\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lexsys.de\/en\/wp-json\/wp\/v2\/users\/5"}],"replies":[{"embeddable":true,"href":"https:\/\/lexsys.de\/en\/wp-json\/wp\/v2\/comments?post=1788"}],"version-history":[{"count":2,"href":"https:\/\/lexsys.de\/en\/wp-json\/wp\/v2\/posts\/1788\/revisions"}],"predecessor-version":[{"id":1824,"href":"https:\/\/lexsys.de\/en\/wp-json\/wp\/v2\/posts\/1788\/revisions\/1824"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/lexsys.de\/en\/wp-json\/wp\/v2\/media\/1821"}],"wp:attachment":[{"href":"https:\/\/lexsys.de\/en\/wp-json\/wp\/v2\/media?parent=1788"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lexsys.de\/en\/wp-json\/wp\/v2\/categories?post=1788"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lexsys.de\/en\/wp-json\/wp\/v2\/tags?post=1788"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}