{"id":9891,"date":"2025-09-18T10:20:17","date_gmt":"2025-09-18T08:20:17","guid":{"rendered":"https:\/\/kabisa.nl\/?p=9891"},"modified":"2025-09-18T12:39:12","modified_gmt":"2025-09-18T10:39:12","slug":"wat-de-rosetta-stone-ons-leert-over-documentatie-en-waarom-ai-daar-niet-zonder-kan","status":"publish","type":"post","link":"https:\/\/kabisa.nl\/nieuws\/wat-de-rosetta-stone-ons-leert-over-documentatie-en-waarom-ai-daar-niet-zonder-kan\/","title":{"rendered":"Wat de Rosetta Stone ons leert over documentatie (en waar AI ons mee kan helpen)"},"content":{"rendered":"\t\t
\n\t\t\t\t
\n\t\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t
\n\t\t\t\t\t\t\t\t\t

Onlangs gaf ik tijdens de Craftsmanship Day bij Kabisa een presentatie over documentatie. Documentatie wordt vaak gezien als saai en overbodig. Maar in de praktijk is het juist cruciaal: het bepaalt of software ook maanden of jaren later nog te begrijpen en te onderhouden is. Zonder documentatie voelt software al snel als een muur vol hi\u00ebrogliefen zonder vertaling.<\/h3>

Rosetta Stone<\/strong><\/h2>

Daarom gebruikte ik de Rosetta Stone als metafoor. In 1799 werd deze steen gevonden in Egypte. Voor het eerst konden wetenschappers hi\u00ebrogliefen ontcijferen, omdat dezelfde tekst er in drie talen opstond: hi\u00ebrogliefen, demotisch en Grieks. Zonder die vertaalslag hadden we nooit geweten wat er stond. Documentatie vervult dezelfde rol in onze wereld van softwareontwikkeling: het maakt kennis toegankelijk, ook als de oorspronkelijke bouwers er niet meer zijn.<\/p>

De prijs van geen documentatie<\/strong><\/h2>

Ik heb gezien bij bedrijven wat er gebeurt wanneer documentatie niet op orde is. Incidenten die steeds weer terugkomen, omdat niemand het onderliggende probleem goed heeft vastgelegd. Nieuwe collega\u2019s die veel langer doen over hun onboarding. En aannames die uitlopen op dure fouten.<\/p>

Het voelt als pleisters plakken: het kost tijd en energie, maar lost niets structureel op.<\/p>

En misschien nog wel belangrijker: documentatie is ook cultuur. Het laat zien dat je rekening houdt met je collega\u2019s. Dat je niet alles alleen in je hoofd wilt houden, maar kennis deelt zodat anderen sneller kunnen werken en minder stress ervaren. Documentatie schrijven is dus \u00f3\u00f3k een sociale daad.<\/p>

\"\"<\/p>

Wat is goede documentatie?<\/strong><\/h2>

Voor mij is documentatie geen ellenlange wiki die ergens staat te verstoffen. Het leeft mee met de praktijk. Soms in de vorm van een architectuurdiagram, soms een kort Architectural Decision Record waarin we vastleggen waarom we iets zo hebben gebouwd, en soms een Standaard Operating Procedure (SOP)<\/em> of runbook dat precies beschrijft wat je moet doen als er iets misgaat. Documentatie werkt alleen als het onderdeel wordt van ons normale werk. Als een feature pas \u201caf\u201d is wanneer er ook een stukje uitleg bij zit. Als we documentatie net zo serieus nemen als code. En als we slimme automatisering inzetten om het bij te houden, zodat het geen extra ballast wordt.<\/p>

De rol van AI<\/h2>

AI gaat daar een enorme rol in spelen (en doet het nu al). Vandaag helpt het al om tekst te schrijven of samen te vatten. Morgen kunnen AI-agents misschien zelfstandig runbooks uitvoeren. Maar AI heeft altijd context nodig. Het kan vaak wel het wat<\/em> uitvoeren, maar niet het waarom<\/em> begrijpen. Die context staat in documentatie. Zonder documentatie blijft AI blind.<\/p>

Onze moderne Rosetta Stone<\/h2>

En dat is misschien wel de belangrijkste boodschap: documentatie is niet alleen voor onszelf, maar ook de brandstof waar AI slimmer van wordt. Zoals de Griekse tekst op de Rosetta Stone ooit de sleutel was tot een hele beschaving, zo kan documentatie nu de sleutel zijn voor duurzame software en AI die ons daadwerkelijk helpt.<\/p>

Mijn tip? Begin klein. Leg vandaag \u00e9\u00e9n keuze vast. Schrijf \u00e9\u00e9n SOP. Zorg dat kennis niet alleen in hoofden zit. Voor je het weet, bouw je samen aan een moderne Rosetta Stone.<\/p>\t\t\t\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t\t\t<\/div>\n\t\t","protected":false},"excerpt":{"rendered":"

Onlangs gaf ik tijdens de Craftsmanship Day bij Kabisa een presentatie over documenteren. Documentatie wordt vaak gezien als saai (en dat is het misschien ook wel een beetje) en overbodig. Maar in de praktijk is het juist cruciaal: het is een van de factoren die bepaalt of software ook maanden of jaren later nog te […]<\/p>\n","protected":false},"author":3,"featured_media":9899,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[123],"tags":[],"class_list":["post-9891","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-nieuws"],"yoast_head":"\nWat de Rosetta Stone ons leert over documentatie (en waar AI ons mee kan helpen) | Kabisa Software Artisans<\/title>\n<meta name=\"description\" content=\"Onlangs gaf ik tijdens de Craftsmanship Day bij Kabisa een presentatie over documenteren. Documentatie wordt vaak gezien als saai (en dat is het misschien\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/kabisa.nl\/en\/nieuws\/wat-de-rosetta-stone-ons-leert-over-documentatie-en-waarom-ai-daar-niet-zonder-kan\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Wat de Rosetta Stone ons leert over documentatie (en waar AI ons mee kan helpen) | Kabisa Software Artisans\" \/>\n<meta property=\"og:description\" content=\"Onlangs gaf ik tijdens de Craftsmanship Day bij Kabisa een presentatie over documenteren. Documentatie wordt vaak gezien als saai (en dat is het misschien\" \/>\n<meta property=\"og:url\" content=\"https:\/\/kabisa.nl\/nieuws\/wat-de-rosetta-stone-ons-leert-over-documentatie-en-waarom-ai-daar-niet-zonder-kan\/\" \/>\n<meta property=\"og:site_name\" content=\"Kabisa Software Artisans\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/kabisaict\" \/>\n<meta property=\"article:published_time\" content=\"2025-09-18T08:20:17+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2025-09-18T10:39:12+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/kabisa.nl\/wp-content\/uploads\/2025\/09\/rosette_stone.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1024\" \/>\n\t<meta property=\"og:image:height\" content=\"683\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Joost Saanen\" \/>\n<meta name=\"twitter:label1\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data1\" content=\"Joost Saanen\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data2\" content=\"4 minutes\" \/>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Wat de Rosetta Stone ons leert over documentatie (en waar AI ons mee kan helpen) | Kabisa Software Artisans","description":"Onlangs gaf ik tijdens de Craftsmanship Day bij Kabisa een presentatie over documenteren. Documentatie wordt vaak gezien als saai (en dat is het misschien","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:\/\/kabisa.nl\/en\/nieuws\/wat-de-rosetta-stone-ons-leert-over-documentatie-en-waarom-ai-daar-niet-zonder-kan\/","og_locale":"en_US","og_type":"article","og_title":"Wat de Rosetta Stone ons leert over documentatie (en waar AI ons mee kan helpen) | Kabisa Software Artisans","og_description":"Onlangs gaf ik tijdens de Craftsmanship Day bij Kabisa een presentatie over documenteren. Documentatie wordt vaak gezien als saai (en dat is het misschien","og_url":"https:\/\/kabisa.nl\/nieuws\/wat-de-rosetta-stone-ons-leert-over-documentatie-en-waarom-ai-daar-niet-zonder-kan\/","og_site_name":"Kabisa Software Artisans","article_publisher":"https:\/\/www.facebook.com\/kabisaict","article_published_time":"2025-09-18T08:20:17+00:00","article_modified_time":"2025-09-18T10:39:12+00:00","og_image":[{"width":1024,"height":683,"url":"https:\/\/kabisa.nl\/wp-content\/uploads\/2025\/09\/rosette_stone.jpg","type":"image\/jpeg"}],"author":"Joost Saanen","twitter_misc":{"Written by":"Joost Saanen","Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/kabisa.nl\/nieuws\/wat-de-rosetta-stone-ons-leert-over-documentatie-en-waarom-ai-daar-niet-zonder-kan\/#article","isPartOf":{"@id":"https:\/\/kabisa.nl\/nieuws\/wat-de-rosetta-stone-ons-leert-over-documentatie-en-waarom-ai-daar-niet-zonder-kan\/"},"author":{"name":"Joost Saanen","@id":"https:\/\/kabisa.nl\/en\/#\/schema\/person\/d5249b38c4a51b8b97cb4f9dc431fc55"},"headline":"Wat de Rosetta Stone ons leert over documentatie (en waar AI ons mee kan helpen)","datePublished":"2025-09-18T08:20:17+00:00","dateModified":"2025-09-18T10:39:12+00:00","mainEntityOfPage":{"@id":"https:\/\/kabisa.nl\/nieuws\/wat-de-rosetta-stone-ons-leert-over-documentatie-en-waarom-ai-daar-niet-zonder-kan\/"},"wordCount":548,"publisher":{"@id":"https:\/\/kabisa.nl\/en\/#organization"},"image":{"@id":"https:\/\/kabisa.nl\/nieuws\/wat-de-rosetta-stone-ons-leert-over-documentatie-en-waarom-ai-daar-niet-zonder-kan\/#primaryimage"},"thumbnailUrl":"https:\/\/kabisa.nl\/wp-content\/uploads\/2025\/09\/rosette_stone.jpg","articleSection":["Nieuws"],"inLanguage":"en-US"},{"@type":"WebPage","@id":"https:\/\/kabisa.nl\/nieuws\/wat-de-rosetta-stone-ons-leert-over-documentatie-en-waarom-ai-daar-niet-zonder-kan\/","url":"https:\/\/kabisa.nl\/nieuws\/wat-de-rosetta-stone-ons-leert-over-documentatie-en-waarom-ai-daar-niet-zonder-kan\/","name":"Wat de Rosetta Stone ons leert over documentatie (en waar AI ons mee kan helpen) | Kabisa Software Artisans","isPartOf":{"@id":"https:\/\/kabisa.nl\/en\/#website"},"primaryImageOfPage":{"@id":"https:\/\/kabisa.nl\/nieuws\/wat-de-rosetta-stone-ons-leert-over-documentatie-en-waarom-ai-daar-niet-zonder-kan\/#primaryimage"},"image":{"@id":"https:\/\/kabisa.nl\/nieuws\/wat-de-rosetta-stone-ons-leert-over-documentatie-en-waarom-ai-daar-niet-zonder-kan\/#primaryimage"},"thumbnailUrl":"https:\/\/kabisa.nl\/wp-content\/uploads\/2025\/09\/rosette_stone.jpg","datePublished":"2025-09-18T08:20:17+00:00","dateModified":"2025-09-18T10:39:12+00:00","description":"Onlangs gaf ik tijdens de Craftsmanship Day bij Kabisa een presentatie over documenteren. Documentatie wordt vaak gezien als saai (en dat is het misschien","breadcrumb":{"@id":"https:\/\/kabisa.nl\/nieuws\/wat-de-rosetta-stone-ons-leert-over-documentatie-en-waarom-ai-daar-niet-zonder-kan\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/kabisa.nl\/nieuws\/wat-de-rosetta-stone-ons-leert-over-documentatie-en-waarom-ai-daar-niet-zonder-kan\/"]}]},{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/kabisa.nl\/nieuws\/wat-de-rosetta-stone-ons-leert-over-documentatie-en-waarom-ai-daar-niet-zonder-kan\/#primaryimage","url":"https:\/\/kabisa.nl\/wp-content\/uploads\/2025\/09\/rosette_stone.jpg","contentUrl":"https:\/\/kabisa.nl\/wp-content\/uploads\/2025\/09\/rosette_stone.jpg","width":1024,"height":683},{"@type":"BreadcrumbList","@id":"https:\/\/kabisa.nl\/nieuws\/wat-de-rosetta-stone-ons-leert-over-documentatie-en-waarom-ai-daar-niet-zonder-kan\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/kabisa.nl\/en\/"},{"@type":"ListItem","position":2,"name":"News","item":"https:\/\/kabisa.nl\/en\/news\/"},{"@type":"ListItem","position":3,"name":"Wat de Rosetta Stone ons leert over documentatie (en waar AI ons mee kan helpen)"}]},{"@type":"WebSite","@id":"https:\/\/kabisa.nl\/en\/#website","url":"https:\/\/kabisa.nl\/en\/","name":"Kabisa Software Artisans","description":"Mission-critical Software for Hightech, Fintech & E-commerce","publisher":{"@id":"https:\/\/kabisa.nl\/en\/#organization"},"alternateName":"Kabisa","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/kabisa.nl\/en\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"},{"@type":"Organization","@id":"https:\/\/kabisa.nl\/en\/#organization","name":"Cloud Legends","alternateName":"Kabisa","url":"https:\/\/kabisa.nl\/en\/","logo":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/kabisa.nl\/en\/#\/schema\/logo\/image\/","url":"https:\/\/kabisa.nl\/wp-content\/uploads\/2022\/12\/kabisa-favicon.png","contentUrl":"https:\/\/kabisa.nl\/wp-content\/uploads\/2022\/12\/kabisa-favicon.png","width":512,"height":512,"caption":"Cloud Legends"},"image":{"@id":"https:\/\/kabisa.nl\/en\/#\/schema\/logo\/image\/"},"sameAs":["https:\/\/www.facebook.com\/kabisaict","https:\/\/x.com\/kabisasoftware"],"description":"Software Development is onze core-business. Kabisa ontwikkelt innovatieve maatwerk software die naadloos aansluit bij de behoeftes van klanten en eindgebruikers. Dat doen we in nauwe samenwerking in elke fase van het proces: co-creatie noemen we dat.","email":"info@kabisa.nl","telephone":"0495 430 798","legalName":"Kabisa B.V.","foundingDate":"2006-01-01","numberOfEmployees":{"@type":"QuantitativeValue","minValue":"51","maxValue":"200"}},{"@type":"Person","@id":"https:\/\/kabisa.nl\/en\/#\/schema\/person\/d5249b38c4a51b8b97cb4f9dc431fc55","name":"Joost Saanen","image":{"@type":"ImageObject","inLanguage":"en-US","@id":"https:\/\/secure.gravatar.com\/avatar\/e3ce2450b8b1bf7e7726b5890b43969e550183e9817d30522994385a96e233f7?s=96&d=mm&r=g","url":"https:\/\/secure.gravatar.com\/avatar\/e3ce2450b8b1bf7e7726b5890b43969e550183e9817d30522994385a96e233f7?s=96&d=mm&r=g","contentUrl":"https:\/\/secure.gravatar.com\/avatar\/e3ce2450b8b1bf7e7726b5890b43969e550183e9817d30522994385a96e233f7?s=96&d=mm&r=g","caption":"Joost Saanen"}}]}},"_links":{"self":[{"href":"https:\/\/kabisa.nl\/en\/wp-json\/wp\/v2\/posts\/9891","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/kabisa.nl\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/kabisa.nl\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/kabisa.nl\/en\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/kabisa.nl\/en\/wp-json\/wp\/v2\/comments?post=9891"}],"version-history":[{"count":21,"href":"https:\/\/kabisa.nl\/en\/wp-json\/wp\/v2\/posts\/9891\/revisions"}],"predecessor-version":[{"id":9947,"href":"https:\/\/kabisa.nl\/en\/wp-json\/wp\/v2\/posts\/9891\/revisions\/9947"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/kabisa.nl\/en\/wp-json\/wp\/v2\/media\/9899"}],"wp:attachment":[{"href":"https:\/\/kabisa.nl\/en\/wp-json\/wp\/v2\/media?parent=9891"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/kabisa.nl\/en\/wp-json\/wp\/v2\/categories?post=9891"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/kabisa.nl\/en\/wp-json\/wp\/v2\/tags?post=9891"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}