{"id":846,"date":"2023-09-28T13:00:57","date_gmt":"2023-09-28T11:00:57","guid":{"rendered":"https:\/\/devops.windhoff-group.de\/?p=846"},"modified":"2023-09-27T15:35:29","modified_gmt":"2023-09-27T13:35:29","slug":"was-bedeutet-documentation-as-code-fuer-devops","status":"publish","type":"post","link":"https:\/\/devops.windhoff-group.de\/was-bedeutet-documentation-as-code-fuer-devops\/","title":{"rendered":"Was bedeutet Documentation as Code f\u00fcr DevOps?"},"content":{"rendered":"<div class=\"row\"  id=\"row-1024546071\">\n\n\t<div id=\"col-626171767\" class=\"col small-12 large-12\"  >\n\t\t\t\t<div class=\"col-inner\"  >\n\t\t\t\n\t\t\t\n<h2>Documentation as Code (DaC) gewinnt als Trend in der Softwareentwicklung immer mehr an Bedeutung. Dabei geht es um die Harmonisierung der Behandlung von Software-Dokumentation mit der von Code. Wie macht sich diese Entwicklung bei DevOps bemerkbar?<\/h2>\n\t<div id=\"gap-1591871257\" class=\"gap-element clearfix\" style=\"display:block; height:auto;\">\n\t\t\n<style>\n#gap-1591871257 {\n  padding-top: 15px;\n}\n<\/style>\n\t<\/div>\n\t\n<div class=\"message-box relative dark\" style=\"padding-top:20px;padding-bottom:20px;\"><div class=\"message-box-bg-image bg-fill fill\" style=\"background-image:url(https:\/\/devops.windhoff-group.de\/wp-content\/uploads\/sites\/14\/2023\/01\/devops-day-header3-1024x512.jpg);\"><\/div><div class=\"message-box-bg-overlay bg-fill fill\" ><\/div><div class=\"container relative\"><div class=\"inner last-reset\">\n<div class=\"row align-middle align-center\"  id=\"row-1373990506\">\n\n\t<div id=\"col-652427480\" class=\"col medium-7 small-12 large-7\"  >\n\t\t\t\t<div class=\"col-inner\"  >\n\t\t\t\n\t\t\t\n\t<div id=\"text-1164687311\" class=\"text\">\n\t\t\n<p style=\"margin-bottom: 0;\">Experten live erleben und aus der Praxis lernen:<br \/>Diese Webinare sollten Sie nicht verpassen!<\/p>\n\t\t\n<style>\n#text-1164687311 {\n  font-size: 1.35rem;\n  line-height: 1.35;\n  text-align: left;\n}\n<\/style>\n\t<\/div>\n\t\n\t<div id=\"gap-2101175928\" class=\"gap-element clearfix show-for-small\" style=\"display:block; height:auto;\">\n\t\t\n<style>\n#gap-2101175928 {\n  padding-top: 30px;\n}\n<\/style>\n\t<\/div>\n\t\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\n\t\n\n\t<div id=\"col-326765113\" class=\"col medium-4 small-12 large-4\"  >\n\t\t\t\t<div class=\"col-inner text-center\"  >\n\t\t\t\n\t\t\t\n<a href=\"https:\/\/devops.windhoff-group.de\/webinare\/\" target=\"_blank\" class=\"button white is-outline is-larger\" rel=\"noopener\"  style=\"border-radius:99px;\">\n\t\t<span>Alle Termine im \u00dcberblick<\/span>\n\t<\/a>\n\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\n\t\n<\/div>\n<\/div><\/div><\/div>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\n\t\n<\/div>\n<div class=\"row\"  id=\"row-169820859\">\n\n\t<div id=\"col-1129051727\" class=\"col small-12 large-12\"  >\n\t\t\t\t<div class=\"col-inner\"  >\n\t\t\t\n\t\t\t\n<p>DaC setzt auf eine Gleichbehandlung von Dokumentation und Softwarecode. F\u00fcr einige Experten ist dieser Ansatz eine wertvolle Erg\u00e4nzung der DevOps-Methodik. Einer von ihnen ist <a href=\"https:\/\/devops.com\/documentation-as-code-a-game-changer-for-devops-teams\/\" target=\"_blank\" rel=\"noopener\">Gilad David Maayan<\/a>, der sich mit dem Thema zuletzt tiefergehend auseinandersetzt hat. Er kommt zu dem Schluss, dass DaC ein wertvolles Werkzeug f\u00fcr DevOps darstellt.<\/p>\n<h3>So profitiert DevOps<\/h3>\n<p>Maayan nennt explizit drei Vorteile:<\/p>\n<h3>1. Zusammenarbeit wird besser<\/h3>\n<p>In vielen F\u00e4llen wird die Dokumentation als zweitrangig wahrgenommen. Sie wird im Anschluss an das Codieren durchgef\u00fchrt. Wenn <a href=\"https:\/\/devops.windhoff-group.de\/devops-im-ueberblick-die-drei\/\" target=\"_blank\" rel=\"noopener\">Entwickler und Betriebsteam in Silos arbeiten<\/a>, entstehen dadurch Engp\u00e4sse und Missverst\u00e4ndnisse. DaC integriert die Dokumentation mit dem Code, sie wird quasi Teil davon. So f\u00f6rdert Documentation as Code eine team\u00fcbergreifende kollaborative Kultur.<\/p>\n<h3>2. Konsistenz und Genauigkeit steigen<\/h3>\n<p>DaC tr\u00e4gt zur Konsistenz und Genauigkeit bei. Das gelingt, indem Tools und Praktiken zum \u00dcberpr\u00fcfen sowie Testen von Code auf die Dokumentation angewendet werden. Automatisierte Validierung stellt sicher, dass die Dokumente den vorab definierten Standards entsprechen und fehlerfrei sind. In Konsequenz k\u00f6nnen die Teams Zeit f\u00fcr manuelle \u00dcberpr\u00fcfungen sparen und menschliche Fehler minimieren. Dar\u00fcber hinaus erleichtert die Platzierung der Dokumentation neben dem Code ihre Synchronisation mit dem aktuellen Systemzustand.<\/p>\n<h3>3. Aktualisierungs- und Wartungsprozesse sind einfacher<\/h3>\n<p>DaC vereinfacht die Prozesse zur Aktualisierung sowie Wartung der Dokumentation. Im Gegensatz zur traditionellen Dokumentation, die schnell veraltet, integriert DaC Aktualisierungen in den Entwicklungsprozess. Sie stellt dadurch sicher, dass die Dokumentation mit den Code-\u00c4nderungen gemeinsam vorangetrieben wird. Diese Integration beseitigt die Aufw\u00e4nde durch getrennte Dokumentationsaktualisierungen. Gleichzeitig stellt sie so sicher, dass sie aktuell bleibt.<\/p>\n<p>In Summe sieht Mayann in DaC weitreichende Vorteile f\u00fcr DevOps. Sein Rat: M\u00f6glichst fr\u00fch mit Documentation as Code parallel zu Softwareentwicklung zu beginnen.<\/p>\n\t\t<\/div>\n\t\t\t\t\t<\/div>\n\n\t\n<\/div>\n<div class=\"is-divider divider clearfix\" ><\/div>\n<h4><strong><span class=\"TextRun SCXW260370071 BCX9\" lang=\"DE-DE\" xml:lang=\"DE-DE\" data-contrast=\"auto\"><span class=\"NormalTextRun SCXW260370071 BCX9\"><span class=\"TextRun SCXW116577706 BCX9\" lang=\"DE-DE\" xml:lang=\"DE-DE\" data-contrast=\"auto\"><span class=\"NormalTextRun SCXW116577706 BCX9\">DevOps&amp;ALM-Beratung@Windhoff Group\u00a0<\/span><\/span><\/span><\/span><\/strong><\/h4>\n<p>Warum sollten Unternehmen\u202fDevOps- oder ALM-Projekte gemeinsam mit der Windhoff Group angehen? Ganz einfach, weil Windhoff vollumf\u00e4ngliche L\u00f6sungen mit Kopf anbietet. Und das ist wortw\u00f6rtlich gemeint.\u202fWindhoff verf\u00fcgt \u00fcber das gew\u00fcnschte Know-how UND den passenden\u202fWindhoffler\u202fdazu.\u202fDabei kommt die Erfahrung aus \u00fcber 20 Jahren in der Softwareentwicklung bei der Gestaltung und dem Betrieb von Entwicklungsumgebungen zur Geltung. Dementsprechend wissen unsere Experten\u202fum die Komplexit\u00e4t von Konzeption, Einf\u00fchrung, Betrieb und Support von\u202fDevOps\u202fund ALM-L\u00f6sungen.<\/p>\n<p>Mehr Informationen und unseren <a href=\"https:\/\/devops.windhoff-group.de\/\">Check-Up \u201eTool-Chain\u201c gibt es hier<\/a> .<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Documentation as Code (DaC) gewinnt als Trend in der Softwareentwicklung immer mehr an Bedeutung.<\/p>\n","protected":false},"author":219,"featured_media":849,"comment_status":"closed","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"content-type":"","footnotes":""},"categories":[3],"tags":[15],"class_list":["post-846","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-devops","tag-devops-tools"],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v23.9 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Was bedeutet Documentation as Code f\u00fcr DevOps? | DevOps Consulting | Windhoff Group<\/title>\n<meta name=\"description\" content=\"Documentation as Code (DaC) gewinnt als Trend in der Softwareentwicklung und Erg\u00e4nzung zur DevOps-Methodik immer mehr an Bedeutung.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/devops.windhoff-group.de\/was-bedeutet-documentation-as-code-fuer-devops\/\" \/>\n<meta property=\"og:locale\" content=\"de_DE\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Was bedeutet Documentation as Code f\u00fcr DevOps? | DevOps Consulting | Windhoff Group\" \/>\n<meta property=\"og:description\" content=\"Documentation as Code (DaC) gewinnt als Trend in der Softwareentwicklung und Erg\u00e4nzung zur DevOps-Methodik immer mehr an Bedeutung.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/devops.windhoff-group.de\/was-bedeutet-documentation-as-code-fuer-devops\/\" \/>\n<meta property=\"og:site_name\" content=\"DevOps Consulting | Windhoff Group\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/windhoffgroup\/\" \/>\n<meta property=\"article:published_time\" content=\"2023-09-28T11:00:57+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2023-09-27T13:35:29+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/devops.windhoff-group.de\/wp-content\/uploads\/sites\/14\/2023\/09\/Header-Vorlage-2023-09-22T140446.335.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"2000\" \/>\n\t<meta property=\"og:image:height\" content=\"900\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Markus B\u00fcssecker\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@windhoff_group\" \/>\n<meta name=\"twitter:site\" content=\"@windhoff_group\" \/>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Was bedeutet Documentation as Code f\u00fcr DevOps? | DevOps Consulting | Windhoff Group","description":"Documentation as Code (DaC) gewinnt als Trend in der Softwareentwicklung und Erg\u00e4nzung zur DevOps-Methodik immer mehr an Bedeutung.","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:\/\/devops.windhoff-group.de\/was-bedeutet-documentation-as-code-fuer-devops\/","og_locale":"de_DE","og_type":"article","og_title":"Was bedeutet Documentation as Code f\u00fcr DevOps? | DevOps Consulting | Windhoff Group","og_description":"Documentation as Code (DaC) gewinnt als Trend in der Softwareentwicklung und Erg\u00e4nzung zur DevOps-Methodik immer mehr an Bedeutung.","og_url":"https:\/\/devops.windhoff-group.de\/was-bedeutet-documentation-as-code-fuer-devops\/","og_site_name":"DevOps Consulting | Windhoff Group","article_publisher":"https:\/\/www.facebook.com\/windhoffgroup\/","article_published_time":"2023-09-28T11:00:57+00:00","article_modified_time":"2023-09-27T13:35:29+00:00","og_image":[{"width":2000,"height":900,"url":"https:\/\/devops.windhoff-group.de\/wp-content\/uploads\/sites\/14\/2023\/09\/Header-Vorlage-2023-09-22T140446.335.jpg","type":"image\/jpeg"}],"author":"Markus B\u00fcssecker","twitter_card":"summary_large_image","twitter_creator":"@windhoff_group","twitter_site":"@windhoff_group","schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/devops.windhoff-group.de\/was-bedeutet-documentation-as-code-fuer-devops\/#article","isPartOf":{"@id":"https:\/\/devops.windhoff-group.de\/was-bedeutet-documentation-as-code-fuer-devops\/"},"author":{"name":"Markus B\u00fcssecker","@id":"https:\/\/devops.windhoff-group.de\/#\/schema\/person\/feb4734a795847ab528c78a5368013e7"},"headline":"Was bedeutet Documentation as Code f\u00fcr DevOps?","datePublished":"2023-09-28T11:00:57+00:00","dateModified":"2023-09-27T13:35:29+00:00","mainEntityOfPage":{"@id":"https:\/\/devops.windhoff-group.de\/was-bedeutet-documentation-as-code-fuer-devops\/"},"wordCount":522,"publisher":{"@id":"https:\/\/devops.windhoff-group.de\/#organization"},"image":{"@id":"https:\/\/devops.windhoff-group.de\/was-bedeutet-documentation-as-code-fuer-devops\/#primaryimage"},"thumbnailUrl":"https:\/\/devops.windhoff-group.de\/wp-content\/uploads\/sites\/14\/2023\/09\/Header-Vorlage-2023-09-22T140446.335.jpg","keywords":["DevOps-Tools"],"articleSection":["DevOps"],"inLanguage":"de"},{"@type":"WebPage","@id":"https:\/\/devops.windhoff-group.de\/was-bedeutet-documentation-as-code-fuer-devops\/","url":"https:\/\/devops.windhoff-group.de\/was-bedeutet-documentation-as-code-fuer-devops\/","name":"Was bedeutet Documentation as Code f\u00fcr DevOps? | DevOps Consulting | Windhoff Group","isPartOf":{"@id":"https:\/\/devops.windhoff-group.de\/#website"},"primaryImageOfPage":{"@id":"https:\/\/devops.windhoff-group.de\/was-bedeutet-documentation-as-code-fuer-devops\/#primaryimage"},"image":{"@id":"https:\/\/devops.windhoff-group.de\/was-bedeutet-documentation-as-code-fuer-devops\/#primaryimage"},"thumbnailUrl":"https:\/\/devops.windhoff-group.de\/wp-content\/uploads\/sites\/14\/2023\/09\/Header-Vorlage-2023-09-22T140446.335.jpg","datePublished":"2023-09-28T11:00:57+00:00","dateModified":"2023-09-27T13:35:29+00:00","description":"Documentation as Code (DaC) gewinnt als Trend in der Softwareentwicklung und Erg\u00e4nzung zur DevOps-Methodik immer mehr an Bedeutung.","breadcrumb":{"@id":"https:\/\/devops.windhoff-group.de\/was-bedeutet-documentation-as-code-fuer-devops\/#breadcrumb"},"inLanguage":"de","potentialAction":[{"@type":"ReadAction","target":["https:\/\/devops.windhoff-group.de\/was-bedeutet-documentation-as-code-fuer-devops\/"]}]},{"@type":"ImageObject","inLanguage":"de","@id":"https:\/\/devops.windhoff-group.de\/was-bedeutet-documentation-as-code-fuer-devops\/#primaryimage","url":"https:\/\/devops.windhoff-group.de\/wp-content\/uploads\/sites\/14\/2023\/09\/Header-Vorlage-2023-09-22T140446.335.jpg","contentUrl":"https:\/\/devops.windhoff-group.de\/wp-content\/uploads\/sites\/14\/2023\/09\/Header-Vorlage-2023-09-22T140446.335.jpg","width":2000,"height":900,"caption":"Documentation as Code kann ein wertvolles Tool f\u00fcr DevOps sein"},{"@type":"BreadcrumbList","@id":"https:\/\/devops.windhoff-group.de\/was-bedeutet-documentation-as-code-fuer-devops\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Startseite","item":"https:\/\/devops.windhoff-group.de\/"},{"@type":"ListItem","position":2,"name":"Was bedeutet Documentation as Code f\u00fcr DevOps?"}]},{"@type":"WebSite","@id":"https:\/\/devops.windhoff-group.de\/#website","url":"https:\/\/devops.windhoff-group.de\/","name":"DevOps Consulting | Windhoff Group","description":"","publisher":{"@id":"https:\/\/devops.windhoff-group.de\/#organization"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/devops.windhoff-group.de\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"de"},{"@type":"Organization","@id":"https:\/\/devops.windhoff-group.de\/#organization","name":"Windhoff Group","url":"https:\/\/devops.windhoff-group.de\/","logo":{"@type":"ImageObject","inLanguage":"de","@id":"https:\/\/devops.windhoff-group.de\/#\/schema\/logo\/image\/","url":"https:\/\/devops.windhoff-group.de\/wp-content\/uploads\/sites\/14\/2021\/12\/DevOps-Logo-bold.png","contentUrl":"https:\/\/devops.windhoff-group.de\/wp-content\/uploads\/sites\/14\/2021\/12\/DevOps-Logo-bold.png","width":888,"height":213,"caption":"Windhoff Group"},"image":{"@id":"https:\/\/devops.windhoff-group.de\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/windhoffgroup\/","https:\/\/x.com\/windhoff_group","https:\/\/www.instagram.com\/windhoff.group\/","https:\/\/de.linkedin.com\/company\/windhoff-software-services","https:\/\/www.youtube.com\/channel\/UCvpOMneiBzfOK5ivotxvB7g"]},{"@type":"Person","@id":"https:\/\/devops.windhoff-group.de\/#\/schema\/person\/feb4734a795847ab528c78a5368013e7","name":"Markus B\u00fcssecker","image":{"@type":"ImageObject","inLanguage":"de","@id":"https:\/\/devops.windhoff-group.de\/#\/schema\/person\/image\/","url":"https:\/\/secure.gravatar.com\/avatar\/776f25df036796ee6ebb767cb7614b69?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/776f25df036796ee6ebb767cb7614b69?s=96&d=mm&r=g","caption":"Markus B\u00fcssecker"}}]}},"_links":{"self":[{"href":"https:\/\/devops.windhoff-group.de\/wp-json\/wp\/v2\/posts\/846","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devops.windhoff-group.de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devops.windhoff-group.de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devops.windhoff-group.de\/wp-json\/wp\/v2\/users\/219"}],"replies":[{"embeddable":true,"href":"https:\/\/devops.windhoff-group.de\/wp-json\/wp\/v2\/comments?post=846"}],"version-history":[{"count":6,"href":"https:\/\/devops.windhoff-group.de\/wp-json\/wp\/v2\/posts\/846\/revisions"}],"predecessor-version":[{"id":854,"href":"https:\/\/devops.windhoff-group.de\/wp-json\/wp\/v2\/posts\/846\/revisions\/854"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devops.windhoff-group.de\/wp-json\/wp\/v2\/media\/849"}],"wp:attachment":[{"href":"https:\/\/devops.windhoff-group.de\/wp-json\/wp\/v2\/media?parent=846"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devops.windhoff-group.de\/wp-json\/wp\/v2\/categories?post=846"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devops.windhoff-group.de\/wp-json\/wp\/v2\/tags?post=846"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}