{"id":1186,"date":"2025-08-13T14:08:04","date_gmt":"2025-08-13T11:08:04","guid":{"rendered":"https:\/\/www.index.fi\/?page_id=1186"},"modified":"2025-09-02T15:52:21","modified_gmt":"2025-09-02T12:52:21","slug":"tekninen-vai-rakenteinen-dokumentti","status":"publish","type":"page","link":"https:\/\/www.index.fi\/en\/tietopankki\/tekninen-vai-rakenteinen-dokumentti\/","title":{"rendered":"Technical document or structural document \u2013 do you know the difference?"},"content":{"rendered":"<div class=\"fusion-fullwidth fullwidth-box fusion-builder-row-1 fusion-flex-container no-bottom-margin nonhundred-percent-fullwidth non-hundred-percent-height-scrolling\" style=\"--awb-border-radius-top-left:0px;--awb-border-radius-top-right:0px;--awb-border-radius-bottom-right:0px;--awb-border-radius-bottom-left:0px;--awb-padding-top-medium:80px;--awb-padding-bottom-medium:80px;--awb-margin-bottom-medium:80px;--awb-margin-bottom-small:60px;--awb-background-color:var(--awb-custom_color_2);--awb-flex-wrap:wrap;\" ><div class=\"fusion-builder-row fusion-row fusion-flex-align-items-stretch fusion-flex-content-wrap\" style=\"max-width:calc( 1200px + 30px );margin-left: calc(-30px \/ 2 );margin-right: calc(-30px \/ 2 );\"><div class=\"fusion-layout-column fusion_builder_column fusion-builder-column-0 fusion_builder_column_1_1 1_1 fusion-flex-column\" style=\"--awb-padding-top:90px;--awb-padding-right:40px;--awb-padding-bottom:80px;--awb-padding-left:40px;--awb-bg-color:var(--awb-custom_color_2);--awb-bg-color-hover:var(--awb-custom_color_2);--awb-bg-size:cover;--awb-width-large:100%;--awb-margin-top-large:0px;--awb-spacing-right-large:10px;--awb-margin-bottom-large:0px;--awb-spacing-left-large:15px;--awb-width-medium:33.333333333333%;--awb-spacing-right-medium:10px;--awb-spacing-left-medium:15px;--awb-width-small:100%;--awb-spacing-right-small:15px;--awb-margin-bottom-small:30px;--awb-spacing-left-small:15px;\"><div class=\"fusion-column-wrapper fusion-column-has-shadow fusion-flex-justify-content-flex-start fusion-content-layout-column\"><i class=\"fb-icon-element-1 fb-icon-element fontawesome-icon classic-thumbs-up-regular circle-no\" style=\"--awb-iconcolor:var(--awb-color4);--awb-iconcolor-hover:var(--awb-color4);--awb-font-size:72px;--awb-align-self:center;--awb-margin-top:0px;--awb-margin-right:0px;--awb-margin-bottom:30px;--awb-margin-left:0px;\"><\/i><div class=\"fusion-title title fusion-title-1 fusion-sep-none fusion-title-text fusion-title-size-one\" style=\"--awb-text-color:#ffffff;--awb-margin-bottom:30px;\"><h1 class=\"fusion-title-heading title-heading-left\" style=\"margin:0;\">Technical document or structural document \u2013 do you know the difference?<\/h1><\/div><div class=\"fusion-text fusion-text-1 fusion-text-no-margin\" style=\"--awb-content-alignment:left;--awb-text-color:#ffffff;--awb-margin-bottom:10%;\"><h2 class=\"\" style=\"text-align: left; --fontsize: 30; line-height: 1.2;\" data-fontsize=\"30\" data-lineheight=\"36px\"><span style=\"color: #ffffff;\">Introduction: terms that can easily get confused<\/span><\/h2>\n<p style=\"text-align: left;\">Technical document, structured document, single-sourcing, modularity, technical writer\u2026 The field of technical communication is teeming with concepts that are partly overlapping, partly complementary \u2013 and often misunderstood. In this article, we will explore what they mean, how they differ from each other, and why understanding them is important, especially for those who work in content production, documentation, or information management.<\/p>\n<h2 class=\"\" style=\"text-align: left; --fontsize: 30; line-height: 1.2;\" data-fontsize=\"30\" data-lineheight=\"36px\"><span style=\"color: #ffffff;\">What is a technical document?<\/span><\/h2>\n<p style=\"text-align: left;\">A technical document is a document that aims to convey technical information in the clearest, most structured and most user-friendly way possible. It can be, for example:<\/p>\n<ul>\n<li style=\"text-align: left;\">Operating or installation instructions<\/li>\n<li style=\"text-align: left;\">API documentation<\/li>\n<li style=\"text-align: left;\">Product information or maintenance instructions<\/li>\n<\/ul>\n<p style=\"text-align: left;\">A technical document can be in any format \u2013 PDF, Word file, or web page \u2013 as long as its content fulfills its purpose: to instruct, clarify, or document a technical matter. What is important is what is said, not necessarily how it is structured.<\/p>\n<h2 class=\"\" style=\"text-align: left; --fontsize: 30; line-height: 1.2;\" data-fontsize=\"30\" data-lineheight=\"36px\"><span style=\"color: #ffffff;\">What about a structured document?<\/span><\/h2>\n<p style=\"text-align: left;\">A structured document is a document in which the content follows a predefined structure. It separates information into content elements \u2013 such as headings, steps, notes, and warnings \u2013 using structures such as XML, DITA, or another markup language.<\/p>\n<p style=\"text-align: left;\">Structure brings with it numerous advantages:<\/p>\n<ul>\n<li style=\"text-align: left;\">Content reuse: the same module can be used in multiple documents<\/li>\n<li style=\"text-align: left;\">Consistency: structure guides writing consistently<\/li>\n<li style=\"text-align: left;\">Automation: publishing to multiple formats is possible without manual work<\/li>\n<li style=\"text-align: left;\">Localization: translation work is faster when content is logically broken down<\/li>\n<\/ul>\n<p style=\"text-align: left;\">All structured documents can be technical, but not all technical documents are structured.<\/p>\n<h3 class=\"\" style=\"text-align: left; --fontsize: 26; line-height: 1.2;\" data-fontsize=\"26\" data-lineheight=\"31.2px\"><span style=\"color: #ffffff;\">Key concepts of structured documentation<\/span><\/h3>\n<p style=\"text-align: left;\">Single-source means that the same content is written once and used in many different contexts. This reduces duplication of work and makes updates easier.<\/p>\n<p style=\"text-align: left;\">Modular documentation divides content into small, independent parts (modules) that can be combined into different documents for different target groups.<\/p>\n<p style=\"text-align: left;\">Multi-channel publishing allows content to be published in different formats \u2013 such as on a website, as PDF or on mobile \u2013 without separate layout or copying.<\/p>\n<h2 class=\"\" style=\"text-align: left; --fontsize: 30; line-height: 1.2;\" data-fontsize=\"30\" data-lineheight=\"36px\"><span style=\"color: #ffffff;\">Technical writer \u2013 content production expert<\/span><\/h2>\n<p style=\"text-align: left;\">A technical writer is a professional responsible for producing technical documents. Their job is not only to write, but also to:<\/p>\n<ul>\n<li style=\"text-align: left;\">Structuring complex information<\/li>\n<li style=\"text-align: left;\">Understanding the needs of the target group<\/li>\n<li style=\"text-align: left;\">Ensuring content accessibility and usability<\/li>\n<li style=\"text-align: left;\">Collaboration with experts, developers and translators<\/li>\n<\/ul>\n<p style=\"text-align: left;\">A technical writer brings the reader's perspective to technical documentation and acts as a bridge between technology and people.<\/p>\n<p style=\"text-align: left;\">Sources:<\/p>\n<p><a href=\"https:\/\/en.wikipedia.org\/wiki\/Technical_writing\" target=\"_blank\" rel=\"noopener noreferrer\">Wikipedia \u2013 Technical writing<\/a><\/p>\n<p><a href=\"https:\/\/en.wikipedia.org\/wiki\/Structured_writing\">Wikipedia \u2013 Structured writing<\/a><\/p>\n<p><a href=\"https:\/\/www.oasis-open.org\/committees\/tc_home.php?wg_abbrev=dita\">OASIS \u2013 DITA Technical Committee<\/a><\/p>\n<\/div><\/div><\/div><\/div><\/div>","protected":false},"excerpt":{"rendered":"","protected":false},"author":1,"featured_media":0,"parent":686,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"100-width.php","meta":{"footnotes":""},"class_list":["post-1186","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.6 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>Tekninen dokumentti vai rakenteinen dokumentti \u2013 tied\u00e4tk\u00f6 eron? - Index IT<\/title>\n<meta name=\"description\" content=\"Tekninen dokumentti vai rakenteinen dokumentti \u2013 osaatko erottaa ne toisistaan? Lue k\u00e4yt\u00e4nn\u00f6nl\u00e4heinen artikkeli dokumentoinnin keskeisist\u00e4 k\u00e4sitteist\u00e4.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/www.index.fi\/en\/tietopankki\/tekninen-vai-rakenteinen-dokumentti\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Tekninen dokumentti vai rakenteinen dokumentti \u2013 tied\u00e4tk\u00f6 eron? - Index IT\" \/>\n<meta property=\"og:description\" content=\"Tekninen dokumentti vai rakenteinen dokumentti \u2013 osaatko erottaa ne toisistaan? Lue k\u00e4yt\u00e4nn\u00f6nl\u00e4heinen artikkeli dokumentoinnin keskeisist\u00e4 k\u00e4sitteist\u00e4.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.index.fi\/en\/tietopankki\/tekninen-vai-rakenteinen-dokumentti\/\" \/>\n<meta property=\"og:site_name\" content=\"Index IT\" \/>\n<meta property=\"article:modified_time\" content=\"2025-09-02T12:52:21+00:00\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/tekninen-vai-rakenteinen-dokumentti\\\/\",\"url\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/tekninen-vai-rakenteinen-dokumentti\\\/\",\"name\":\"Tekninen dokumentti vai rakenteinen dokumentti \u2013 tied\u00e4tk\u00f6 eron? - Index IT\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.index.fi\\\/#website\"},\"datePublished\":\"2025-08-13T11:08:04+00:00\",\"dateModified\":\"2025-09-02T12:52:21+00:00\",\"description\":\"Tekninen dokumentti vai rakenteinen dokumentti \u2013 osaatko erottaa ne toisistaan? Lue k\u00e4yt\u00e4nn\u00f6nl\u00e4heinen artikkeli dokumentoinnin keskeisist\u00e4 k\u00e4sitteist\u00e4.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/tekninen-vai-rakenteinen-dokumentti\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/tekninen-vai-rakenteinen-dokumentti\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/tekninen-vai-rakenteinen-dokumentti\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Etusivu\",\"item\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tietopankki\",\"item\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Tekninen dokumentti vai rakenteinen dokumentti \u2013 tied\u00e4tk\u00f6 eron?\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/www.index.fi\\\/#website\",\"url\":\"https:\\\/\\\/www.index.fi\\\/\",\"name\":\"Index IT\",\"description\":\"Index IT\",\"publisher\":{\"@id\":\"https:\\\/\\\/www.index.fi\\\/#organization\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/www.index.fi\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"},{\"@type\":\"Organization\",\"@id\":\"https:\\\/\\\/www.index.fi\\\/#organization\",\"name\":\"Index IT\",\"url\":\"https:\\\/\\\/www.index.fi\\\/\",\"logo\":{\"@type\":\"ImageObject\",\"inLanguage\":\"en-US\",\"@id\":\"https:\\\/\\\/www.index.fi\\\/#\\\/schema\\\/logo\\\/image\\\/\",\"url\":\"https:\\\/\\\/www.index.fi\\\/wp-content\\\/uploads\\\/2023\\\/09\\\/Logo_digi.png\",\"contentUrl\":\"https:\\\/\\\/www.index.fi\\\/wp-content\\\/uploads\\\/2023\\\/09\\\/Logo_digi.png\",\"width\":2165,\"height\":570,\"caption\":\"Index IT\"},\"image\":{\"@id\":\"https:\\\/\\\/www.index.fi\\\/#\\\/schema\\\/logo\\\/image\\\/\"},\"sameAs\":[\"https:\\\/\\\/www.linkedin.com\\\/company\\\/index-information-technologies-oy\\\/\"]}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Tekninen dokumentti vai rakenteinen dokumentti \u2013 tied\u00e4tk\u00f6 eron? - Index IT","description":"Tekninen dokumentti vai rakenteinen dokumentti \u2013 osaatko erottaa ne toisistaan? Lue k\u00e4yt\u00e4nn\u00f6nl\u00e4heinen artikkeli dokumentoinnin keskeisist\u00e4 k\u00e4sitteist\u00e4.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/www.index.fi\/en\/tietopankki\/tekninen-vai-rakenteinen-dokumentti\/","og_locale":"en_US","og_type":"article","og_title":"Tekninen dokumentti vai rakenteinen dokumentti \u2013 tied\u00e4tk\u00f6 eron? - Index IT","og_description":"Tekninen dokumentti vai rakenteinen dokumentti \u2013 osaatko erottaa ne toisistaan? Lue k\u00e4yt\u00e4nn\u00f6nl\u00e4heinen artikkeli dokumentoinnin keskeisist\u00e4 k\u00e4sitteist\u00e4.","og_url":"https:\/\/www.index.fi\/en\/tietopankki\/tekninen-vai-rakenteinen-dokumentti\/","og_site_name":"Index IT","article_modified_time":"2025-09-02T12:52:21+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.index.fi\/fi\/tietopankki\/tekninen-vai-rakenteinen-dokumentti\/","url":"https:\/\/www.index.fi\/fi\/tietopankki\/tekninen-vai-rakenteinen-dokumentti\/","name":"Tekninen dokumentti vai rakenteinen dokumentti \u2013 tied\u00e4tk\u00f6 eron? - Index IT","isPartOf":{"@id":"https:\/\/www.index.fi\/#website"},"datePublished":"2025-08-13T11:08:04+00:00","dateModified":"2025-09-02T12:52:21+00:00","description":"Tekninen dokumentti vai rakenteinen dokumentti \u2013 osaatko erottaa ne toisistaan? Lue k\u00e4yt\u00e4nn\u00f6nl\u00e4heinen artikkeli dokumentoinnin keskeisist\u00e4 k\u00e4sitteist\u00e4.","breadcrumb":{"@id":"https:\/\/www.index.fi\/fi\/tietopankki\/tekninen-vai-rakenteinen-dokumentti\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.index.fi\/fi\/tietopankki\/tekninen-vai-rakenteinen-dokumentti\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.index.fi\/fi\/tietopankki\/tekninen-vai-rakenteinen-dokumentti\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Etusivu","item":"https:\/\/www.index.fi\/fi\/"},{"@type":"ListItem","position":2,"name":"Tietopankki","item":"https:\/\/www.index.fi\/fi\/tietopankki\/"},{"@type":"ListItem","position":3,"name":"Tekninen dokumentti vai rakenteinen dokumentti \u2013 tied\u00e4tk\u00f6 eron?"}]},{"@type":"WebSite","@id":"https:\/\/www.index.fi\/#website","url":"https:\/\/www.index.fi\/","name":"Index IT","description":"Index IT","publisher":{"@id":"https:\/\/www.index.fi\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/www.index.fi\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/www.index.fi\/#organization","name":"Index IT","url":"https:\/\/www.index.fi\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/www.index.fi\/#\/schema\/logo\/image\/","url":"https:\/\/www.index.fi\/wp-content\/uploads\/2023\/09\/Logo_digi.png","contentUrl":"https:\/\/www.index.fi\/wp-content\/uploads\/2023\/09\/Logo_digi.png","width":2165,"height":570,"caption":"Index IT"},"image":{"@id":"https:\/\/www.index.fi\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.linkedin.com\/company\/index-information-technologies-oy\/"]}]}},"_links":{"self":[{"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/pages\/1186","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/pages"}],"about":[{"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/types\/page"}],"author":[{"embeddable":true,"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/comments?post=1186"}],"version-history":[{"count":10,"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/pages\/1186\/revisions"}],"predecessor-version":[{"id":1221,"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/pages\/1186\/revisions\/1221"}],"up":[{"embeddable":true,"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/pages\/686"}],"wp:attachment":[{"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/media?parent=1186"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}