{"id":691,"date":"2024-03-22T14:17:52","date_gmt":"2024-03-22T12:17:52","guid":{"rendered":"https:\/\/www.index.fi\/?page_id=691"},"modified":"2026-06-25T21:45:37","modified_gmt":"2026-06-25T18:45:37","slug":"dita-docs-as-code","status":"publish","type":"page","link":"https:\/\/www.index.fi\/en\/tietopankki\/dita-docsascode\/","title":{"rendered":"DITA Docs as Code"},"content":{"rendered":"
<\/i>

How to Integrate DITA with Docs as Code: A Guide to Agile Technical Documentation<\/h1><\/div>

What is Docs as Code?<\/strong><\/p>\n

A typical problem with documentation is that it lags behind product versions or does not correspond to different versions of a modular product. With a modular approach, the documentation can be targeted to match the product configuration. The goal of the method is to combine the development of the product and its documentation. This is achieved by applying the same proven tools and methods to documentation as to software development. These tools and methods vary from organization to organization. The starting points of Docs as Code are:<\/p>\n

\u2013 The document is in a standard text format, such as DITA, HTML or Markdown. These can be modified with text editors developed for them, for example Oxygen XML Editor.<\/p>\n

\u2013 A service management system (e.g. Jira) for change management, which is also typically used in software development. The purpose is to ensure that product changes are also reflected in the documentation.<\/p>\n

Version control (Git), in the Docs as Code method, documentation typically follows the versions of the product being documented. Alternatively, Indox can be used, which has workflow support.<\/p>\n

\u2013 Automatic compilation and distribution of documentation. If there are changes to the documentation, it triggers compilation, which creates documentation suitable for the new version. This corresponds to the CI\/CD thinking of software development, i.e. continuous integration and continuous delivery. Thanks to the modularity of the documentation, it is possible to target the documentation to match the customer's product configuration.<\/p>\n

Documentation testing can be automated by, for example, validating against DTD\/schema and using automation for terminology checks, such as the Vale application.<\/p>\n

\u2013 Documentation is combined with the development method used. For example, the Scrum of software development, where documentation is done as part of sprints.<\/p>\n

The Docs as Code method can be implemented so that the entire development team is responsible for documentation. Software developers participate in documentation as part of their development work by writing in Markdown or DITA. Technical writers style and organize the material.<\/p>\n

DITA is perfect for the Docs as Code method<\/span><\/h2>\n

DITA is a text-based format compliant with the Oasis standard, which enables seamless transfer of content between systems or effortless switching of tools. Other text-based formats, such as Markdown and HTML (LWDITA), can be combined with DITA. Thanks to its text-based nature, versioning tools can be used, and comparisons are easy. DITA's modularity and reusability facilitate the creation of various documentation sets from the same source material. DITA enables multiple distribution formats, such as HTML (WebHelp) and PDF. Publishing is typically done using the open-source DITA-OT tool. DITA's semantics allow for diverse testing. Context can be considered in testing, for example, titles must be in a specific format.<\/p>\n

Conclusions<\/span><\/h2>\n

DITA fits well with the Docs as Code method. Complex documentation can be done with DITA, but for easier documentation it can be kept simple. DITA enables the controlled development of documentation as the product becomes more complex over the years. Index IT helps your organization move to the Docs as Code method.<\/p>\n

Sources:<\/strong><\/p>\n

https:\/\/istc.org.uk\/wp-content\/uploads\/2021\/11\/George-Bina-%E2%80%93-Docs-as-Code-and-DITA.pdf<\/p>\n<\/div><\/div><\/div>

\"Manu<\/span><\/div>

Manu Ojanen<\/b><\/p>\n

The author is an experienced software developer at Index IT and is responsible for the development of Indox CCMS.<\/p>\n<\/div><\/div><\/div>\n<\/div><\/div>","protected":false},"excerpt":{"rendered":"","protected":false},"author":4,"featured_media":0,"parent":686,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"100-width.php","meta":{"footnotes":""},"class_list":["post-691","page","type-page","status-publish","hentry"],"yoast_head":"\nDITA Docs as Code - Index IT<\/title>\n<meta name=\"description\" content=\"Mit\u00e4 on Docs as Code? Tutustu menetelm\u00e4\u00e4n, jossa dokumentointi integroidaan ohjelmistokehitykseen versionhallinnan, automaation ja CI\/CD-mallien avulla.\" \/>\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\/knowledge-base\/dita-docs-as-code\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"DITA Docs as Code - Index IT\" \/>\n<meta property=\"og:description\" content=\"Mit\u00e4 on Docs as Code? Tutustu menetelm\u00e4\u00e4n, jossa dokumentointi integroidaan ohjelmistokehitykseen versionhallinnan, automaation ja CI\/CD-mallien avulla.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/www.index.fi\/en\/knowledge-base\/dita-docs-as-code\/\" \/>\n<meta property=\"og:site_name\" content=\"Index IT\" \/>\n<meta property=\"article:modified_time\" content=\"2026-06-25T18:45:37+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=\"3 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-docsascode\\\/\",\"url\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita-docsascode\\\/\",\"name\":\"DITA Docs as Code - Index IT\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/www.index.fi\\\/#website\"},\"datePublished\":\"2024-03-22T12:17:52+00:00\",\"dateModified\":\"2026-06-25T18:45:37+00:00\",\"description\":\"Mit\u00e4 on Docs as Code? Tutustu menetelm\u00e4\u00e4n, jossa dokumentointi integroidaan ohjelmistokehitykseen versionhallinnan, automaation ja CI\\\/CD-mallien avulla.\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita-docsascode\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita-docsascode\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/www.index.fi\\\/fi\\\/tietopankki\\\/dita-docsascode\\\/#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 Docs as Code\"}]},{\"@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 Docs as Code - Index IT","description":"What is Docs as Code? Explore a methodology where documentation is integrated into software development using version control, automation, and CI\/CD models.","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\/knowledge-base\/dita-docs-as-code\/","og_locale":"en_US","og_type":"article","og_title":"DITA Docs as Code - Index IT","og_description":"Mit\u00e4 on Docs as Code? Tutustu menetelm\u00e4\u00e4n, jossa dokumentointi integroidaan ohjelmistokehitykseen versionhallinnan, automaation ja CI\/CD-mallien avulla.","og_url":"https:\/\/www.index.fi\/en\/knowledge-base\/dita-docs-as-code\/","og_site_name":"Index IT","article_modified_time":"2026-06-25T18:45:37+00:00","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"3 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/www.index.fi\/fi\/tietopankki\/dita-docsascode\/","url":"https:\/\/www.index.fi\/fi\/tietopankki\/dita-docsascode\/","name":"DITA Docs as Code - Index IT","isPartOf":{"@id":"https:\/\/www.index.fi\/#website"},"datePublished":"2024-03-22T12:17:52+00:00","dateModified":"2026-06-25T18:45:37+00:00","description":"What is Docs as Code? Explore a methodology where documentation is integrated into software development using version control, automation, and CI\/CD models.","breadcrumb":{"@id":"https:\/\/www.index.fi\/fi\/tietopankki\/dita-docsascode\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/www.index.fi\/fi\/tietopankki\/dita-docsascode\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/www.index.fi\/fi\/tietopankki\/dita-docsascode\/#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 Docs as Code"}]},{"@type":"WebSite","@id":"https:\/\/www.index.fi\/#website","url":"https:\/\/www.index.fi\/","name":"IT Index","description":"IT Index","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":"IT Index","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\/691","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\/4"}],"replies":[{"embeddable":true,"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/comments?post=691"}],"version-history":[{"count":12,"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/pages\/691\/revisions"}],"predecessor-version":[{"id":1371,"href":"https:\/\/www.index.fi\/en\/wp-json\/wp\/v2\/pages\/691\/revisions\/1371"}],"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=691"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}