{"id":1013,"date":"2025-06-19T12:16:43","date_gmt":"2025-06-19T09:16:43","guid":{"rendered":"https:\/\/www.index.fi\/?page_id=1013"},"modified":"2025-09-05T11:19:08","modified_gmt":"2025-09-05T08:19:08","slug":"dita-kayttoonotto","status":"publish","type":"page","link":"https:\/\/www.index.fi\/en\/tietopankki\/dita-kayttoonotto\/","title":{"rendered":"Implementing DITA"},"content":{"rendered":"
<\/i>

Implementing DITA in the documentation process<\/strong><\/h1><\/div>

DITA (Darwin Information Typing Architecture) provides an efficient way to manage technical documentation in a modular and reusable way. However, its implementation can be challenging, especially for teams with no prior experience with structured writing or XML. A successful transition requires planning, the right tools, and a reassessment of content creation processes. This article will walk you through the key steps to implementing DITA.<\/p>\n

    \n
  1. Identify needs and goals
    \nStart by mapping out why you want to move to DITA. Is your goal content reuse, multilingual publishing, a more efficient update process, or a scalable documentation structure? A clear goal will help you choose the right tools and resources.<\/li>\n
  2. Train the team
    \nDITA brings a new way of thinking: topic-based and structured writing. Make sure that writers have basic training in DITA and understand concepts such as topic types (task, concept, reference), content maps, and metadata.<\/li>\n
  3. Choose the right tools
    \nDITA requires an editor that supports XML formatting and the DITA structure. Popular options include Oxygen XML Editor, DITA Open Toolkit, and Component Content Management Systems (CCMSs), which facilitate version control and publishing to multiple channels.<\/li>\n
  4. Plan your content structure
    \nA well-designed information model is the backbone of a DITA project. Determine how content will be divided into topics, what reuse needs there are, and how content will be assembled into publications. It is also worth planning metadata and taxonomies carefully from the beginning.<\/li>\n
  5. Start small, scale later
    \nDon\u2019t try to migrate everything at once. Choose a pilot project\u2014for example, a single user guide or product line\u2014and use it as a test bed for your DITA adoption. Gather feedback and iteratively develop the process.<\/li>\n<\/ol>\n

    Summary<\/strong>:
    \nImplementing DITA requires planning, but the rewards are clarity, efficiency, and scalability. When the process is done in stages and users are properly trained, DITA can bring significant benefits to technical documentation, both in terms of content management and end-user experience.<\/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-1013","page","type-page","status-publish","hentry"],"yoast_head":"\nDITA:n k\u00e4ytt\u00f6\u00f6notto - Index IT<\/title>\n<meta name=\"description\" content=\"DITA:n k\u00e4ytt\u00f6\u00f6notto selkeytt\u00e4\u00e4 ja tehostaa dokumentointia. Katso viisi keskeist\u00e4 vaihetta, joilla onnistut projektin aloituksessa ja skaalaamisessa.\" \/>\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-kayttoonotto\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"DITA:n k\u00e4ytt\u00f6\u00f6notto - Index IT\" \/>\n<meta property=\"og:description\" content=\"DITA:n k\u00e4ytt\u00f6\u00f6notto selkeytt\u00e4\u00e4 ja tehostaa dokumentointia. Katso viisi keskeist\u00e4 vaihetta, joilla onnistut projektin aloituksessa ja skaalaamisessa.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.index.fi\/en\/tietopankki\/dita-kayttoonotto\/\" \/>\n<meta property=\"og:site_name\" content=\"Index IT\" \/>\n<meta property=\"article:modified_time\" content=\"2025-09-05T08:19:08+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\\\/dita-kayttoonotto\\\/\",\"url\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita-kayttoonotto\\\/\",\"name\":\"DITA:n k\u00e4ytt\u00f6\u00f6notto - Index IT\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.index.fi\\\/#website\"},\"datePublished\":\"2025-06-19T09:16:43+00:00\",\"dateModified\":\"2025-09-05T08:19:08+00:00\",\"description\":\"DITA:n k\u00e4ytt\u00f6\u00f6notto selkeytt\u00e4\u00e4 ja tehostaa dokumentointia. Katso viisi keskeist\u00e4 vaihetta, joilla onnistut projektin aloituksessa ja skaalaamisessa.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita-kayttoonotto\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita-kayttoonotto\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita-kayttoonotto\\\/#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:n k\u00e4ytt\u00f6\u00f6notto\"}]},{\"@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:n k\u00e4ytt\u00f6\u00f6notto - Index IT","description":"DITA:n k\u00e4ytt\u00f6\u00f6notto selkeytt\u00e4\u00e4 ja tehostaa dokumentointia. Katso viisi keskeist\u00e4 vaihetta, joilla onnistut projektin aloituksessa ja skaalaamisessa.","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-kayttoonotto\/","og_locale":"en_US","og_type":"article","og_title":"DITA:n k\u00e4ytt\u00f6\u00f6notto - Index IT","og_description":"DITA:n k\u00e4ytt\u00f6\u00f6notto selkeytt\u00e4\u00e4 ja tehostaa dokumentointia. Katso viisi keskeist\u00e4 vaihetta, joilla onnistut projektin aloituksessa ja skaalaamisessa.","og_url":"https:\/\/www.index.fi\/en\/tietopankki\/dita-kayttoonotto\/","og_site_name":"Index IT","article_modified_time":"2025-09-05T08:19:08+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\/dita-kayttoonotto\/","url":"https:\/\/www.index.fi\/fi\/tietopankki\/dita-kayttoonotto\/","name":"DITA:n k\u00e4ytt\u00f6\u00f6notto - Index IT","isPartOf":{"@id":"https:\/\/www.index.fi\/#website"},"datePublished":"2025-06-19T09:16:43+00:00","dateModified":"2025-09-05T08:19:08+00:00","description":"DITA:n k\u00e4ytt\u00f6\u00f6notto selkeytt\u00e4\u00e4 ja tehostaa dokumentointia. Katso viisi keskeist\u00e4 vaihetta, joilla onnistut projektin aloituksessa ja skaalaamisessa.","breadcrumb":{"@id":"https:\/\/www.index.fi\/fi\/tietopankki\/dita-kayttoonotto\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.index.fi\/fi\/tietopankki\/dita-kayttoonotto\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.index.fi\/fi\/tietopankki\/dita-kayttoonotto\/#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:n k\u00e4ytt\u00f6\u00f6notto"}]},{"@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\/1013","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=1013"}],"version-history":[{"count":6,"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/pages\/1013\/revisions"}],"predecessor-version":[{"id":1242,"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/pages\/1013\/revisions\/1242"}],"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=1013"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}