{"id":1017,"date":"2025-06-23T19:06:07","date_gmt":"2025-06-23T16:06:07","guid":{"rendered":"https:\/\/www.index.fi\/?page_id=1017"},"modified":"2025-09-05T11:19:12","modified_gmt":"2025-09-05T08:19:12","slug":"dita-aiheiden-maarittely-ja-jasentely-tehokkaasti","status":"publish","type":"page","link":"https:\/\/www.index.fi\/en\/tietopankki\/dita-aiheiden-maarittely-ja-jasentely-tehokkaasti\/","title":{"rendered":"Defining and structuring DITA topics effectively"},"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;\"><h1><strong>Defining and structuring DITA topics effectively<\/strong><\/h1><\/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><span style=\"color: #ffffff;\">What is a \u201ctopic\u201d in DITA content?<\/span><\/h2>\n<p>DITA documentation is structured on a topic basis. Each topic is an independent content unit that deals with a precisely defined issue \u2013 for example, instructions, concepts or technical information. This makes the content easy to manage, reuse and edit.<\/p>\n<h2><span style=\"color: #ffffff;\">Why is DITA topic definition important?<\/span><\/h2>\n<p>Clearly defined topics allow for modular documentation, where each section functions as a separate piece. This allows content to be:<\/p>\n<ul>\n<li>use in different publications without copying<\/li>\n<li>update centrally<\/li>\n<li>efficiently translate into multiple languages<\/li>\n<li>How does a good topic improve content management?<\/li>\n<\/ul>\n<p>When a topic is structured consistently, the entire documentation benefits. There are fewer overlaps, publishing is faster, and quality is easier to manage. Version control and team collaboration are also significantly improved.<\/p>\n<h2><span style=\"color: #ffffff;\">How do I succeed in structuring DITA topics?<\/span><\/h2>\n<p>Start by thinking: does the topic deal with only one thing? If the answer is yes, you are on the right track. Use ready-made topic types (task, concept, reference) when necessary, name the topics logically and avoid multi-thematic entities. A clear structure helps both the writer and the reader.<\/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-1017","page","type-page","status-publish","hentry"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v27.5 - https:\/\/yoast.com\/product\/yoast-seo-wordpress\/ -->\n<title>DITA-aiheiden m\u00e4\u00e4rittely ja j\u00e4sentely tehokkaasti - Index IT<\/title>\n<meta name=\"description\" content=\"DITA-aiheiden tehokas m\u00e4\u00e4rittely parantaa sis\u00e4ll\u00f6nhallintaa, v\u00e4hent\u00e4\u00e4 p\u00e4\u00e4llekk\u00e4isyyksi\u00e4 ja helpottaa yll\u00e4pitoa. Katso k\u00e4yt\u00e4nn\u00f6n vinkit ja ohjeet.\" \/>\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\/dita-aiheiden-maarittely-ja-jasentely-tehokkaasti\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"DITA-aiheiden m\u00e4\u00e4rittely ja j\u00e4sentely tehokkaasti - Index IT\" \/>\n<meta property=\"og:description\" content=\"DITA-aiheiden tehokas m\u00e4\u00e4rittely parantaa sis\u00e4ll\u00f6nhallintaa, v\u00e4hent\u00e4\u00e4 p\u00e4\u00e4llekk\u00e4isyyksi\u00e4 ja helpottaa yll\u00e4pitoa. Katso k\u00e4yt\u00e4nn\u00f6n vinkit ja ohjeet.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.index.fi\/en\/tietopankki\/dita-aiheiden-maarittely-ja-jasentely-tehokkaasti\/\" \/>\n<meta property=\"og:site_name\" content=\"Index IT\" \/>\n<meta property=\"article:modified_time\" content=\"2025-09-05T08:19:12+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=\"1 minute\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita-aiheiden-maarittely-ja-jasentely-tehokkaasti\\\/\",\"url\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita-aiheiden-maarittely-ja-jasentely-tehokkaasti\\\/\",\"name\":\"DITA-aiheiden m\u00e4\u00e4rittely ja j\u00e4sentely tehokkaasti - Index IT\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.index.fi\\\/#website\"},\"datePublished\":\"2025-06-23T16:06:07+00:00\",\"dateModified\":\"2025-09-05T08:19:12+00:00\",\"description\":\"DITA-aiheiden tehokas m\u00e4\u00e4rittely parantaa sis\u00e4ll\u00f6nhallintaa, v\u00e4hent\u00e4\u00e4 p\u00e4\u00e4llekk\u00e4isyyksi\u00e4 ja helpottaa yll\u00e4pitoa. Katso k\u00e4yt\u00e4nn\u00f6n vinkit ja ohjeet.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita-aiheiden-maarittely-ja-jasentely-tehokkaasti\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita-aiheiden-maarittely-ja-jasentely-tehokkaasti\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita-aiheiden-maarittely-ja-jasentely-tehokkaasti\\\/#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\":\"DITA-aiheiden m\u00e4\u00e4rittely ja j\u00e4sentely tehokkaasti\"}]},{\"@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":"DITA-aiheiden m\u00e4\u00e4rittely ja j\u00e4sentely tehokkaasti - Index IT","description":"DITA-aiheiden tehokas m\u00e4\u00e4rittely parantaa sis\u00e4ll\u00f6nhallintaa, v\u00e4hent\u00e4\u00e4 p\u00e4\u00e4llekk\u00e4isyyksi\u00e4 ja helpottaa yll\u00e4pitoa. Katso k\u00e4yt\u00e4nn\u00f6n vinkit ja ohjeet.","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\/dita-aiheiden-maarittely-ja-jasentely-tehokkaasti\/","og_locale":"en_US","og_type":"article","og_title":"DITA-aiheiden m\u00e4\u00e4rittely ja j\u00e4sentely tehokkaasti - Index IT","og_description":"DITA-aiheiden tehokas m\u00e4\u00e4rittely parantaa sis\u00e4ll\u00f6nhallintaa, v\u00e4hent\u00e4\u00e4 p\u00e4\u00e4llekk\u00e4isyyksi\u00e4 ja helpottaa yll\u00e4pitoa. Katso k\u00e4yt\u00e4nn\u00f6n vinkit ja ohjeet.","og_url":"https:\/\/www.index.fi\/en\/tietopankki\/dita-aiheiden-maarittely-ja-jasentely-tehokkaasti\/","og_site_name":"Index IT","article_modified_time":"2025-09-05T08:19:12+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"1 minute"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.index.fi\/fi\/tietopankki\/dita-aiheiden-maarittely-ja-jasentely-tehokkaasti\/","url":"https:\/\/www.index.fi\/fi\/tietopankki\/dita-aiheiden-maarittely-ja-jasentely-tehokkaasti\/","name":"DITA-aiheiden m\u00e4\u00e4rittely ja j\u00e4sentely tehokkaasti - Index IT","isPartOf":{"@id":"https:\/\/www.index.fi\/#website"},"datePublished":"2025-06-23T16:06:07+00:00","dateModified":"2025-09-05T08:19:12+00:00","description":"DITA-aiheiden tehokas m\u00e4\u00e4rittely parantaa sis\u00e4ll\u00f6nhallintaa, v\u00e4hent\u00e4\u00e4 p\u00e4\u00e4llekk\u00e4isyyksi\u00e4 ja helpottaa yll\u00e4pitoa. Katso k\u00e4yt\u00e4nn\u00f6n vinkit ja ohjeet.","breadcrumb":{"@id":"https:\/\/www.index.fi\/fi\/tietopankki\/dita-aiheiden-maarittely-ja-jasentely-tehokkaasti\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.index.fi\/fi\/tietopankki\/dita-aiheiden-maarittely-ja-jasentely-tehokkaasti\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.index.fi\/fi\/tietopankki\/dita-aiheiden-maarittely-ja-jasentely-tehokkaasti\/#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":"DITA-aiheiden m\u00e4\u00e4rittely ja j\u00e4sentely tehokkaasti"}]},{"@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\/1017","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=1017"}],"version-history":[{"count":10,"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/pages\/1017\/revisions"}],"predecessor-version":[{"id":1241,"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/pages\/1017\/revisions\/1241"}],"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=1017"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}