Informatiebeheer en documentatie

Huidige stand van zaken en vooruitzichten

softwaredocumentatie

Hoeveel tijd verspilt jouw team elke week met het zoeken naar informatie die ergens al bestaat?

In een onderzoek uit 2001 werd geschat dat een werknemer een derde van zijn dag besteedde aan het zoeken naar informatie. Deze cijfers, die sindsdien zijn betwist, moeten met de nodige voorzichtigheid worden geïnterpreteerd. Maar de kwalitatieve constatering blijft ook in 2026 geldig: ondanks decennia van investeringen in documentbeheer, bedrijfsbrede zoekfuncties, samenwerkingsplatforms en moderne documentatiemethoden blijft informatiebeheer in de meeste organisaties een probleem.

Volgens een taxonomie die is gebaseerd op 878 praktijkvoorbeelden van documentatie, zijn er talrijke scenario’s: documentatie die ontbreekt, verouderd is, onvolledig is, niet overeenkomt met processen of code, onleesbaar is of onvindbaar is. De risico’s reiken verder dan alleen productiviteit. Het niet naleven van regelgeving kan ernstige gevolgen hebben. Het vertrek van een ‘lokale goeroe’ kan een hele bedrijfsvoering lamleggen.

De beperkingen van eerdere benaderingen

Elke generatie gereedschappen heeft iets bijgedragen. Geen enkele heeft echter een probleem opgelost waarvan de oorzaken opmerkelijk stabiel blijven.

De onevenwichtigheid tussen inspanning en opbrengst. Degene die de documentatie opstelt, is niet degene die er voordeel uit haalt, en documentatie wordt gezien als tijdverspilling in vergelijking met productievere taken.

Het ontbreken van een feedbackmechanisme. Een test die mislukt, leidt onmiddellijk tot een waarschuwing. Dat documentatie onjuist is geworden, valt de lezer pas later op, zonder enige waarschuwing vooraf.

De vicieuze cirkel van vertrouwen. Verouderde documentatie ondermijnt het vertrouwen in de informatie en demotiveert degenen die de moeite hebben genomen om deze bij te houden.

Cultuur gaat boven processen. Ondanks formeel goed gedefinieerde processen blijven er ernstige documentatieproblemen bestaan. Geen enkele tool heeft dit ooit kunnen verhelpen.

De menselijke kosten. Diátaxis [4] is een robuuste methodologie, maar vereist voortdurende redactionele discipline, en het handmatig controleren van een bestaand corpus wordt al snel onbeheersbaar.

De voordelen en beperkingen van kunstmatige intelligentie

Van deze vijf oorzaken pakt kunstmatige intelligentie er slechts twee aan: die welke verband houden met tijd en detectie. De asymmetrie in voordelen en de invloed van de organisatiecultuur blijven haar volkomen vreemd. Ze verricht geen wonderen: ze genereert geen kennis die niet bestaat, en aangezien ze niet-deterministisch is, biedt ze geen garantie voor de nauwkeurigheid van wat ze voortbrengt. Haar betrouwbaarheid is dan ook nooit absoluut.

Toch moet dit criterium op een eerlijke manier worden toegepast. Een antwoord dat je van een collega krijgt, is niet per se betrouwbaarder: die kan zich vergissen, een oudere versie van het systeem in gedachten hebben of redeneren binnen een verwante context. Hetzelfde geldt voor een document dat je op het intranet vindt; er is geen garantie dat het up-to-date is of dat het is gecontroleerd. Organisaties hebben altijd al met onzekere informatie gewerkt. Ze hebben geleerd deze te beoordelen op basis van de context: wie heeft het geschreven, wanneer en met welk doel. Kunstmatige intelligentie lost dit probleem niet op, en beweren dat het wel zo is, zou een analysefout zijn.

Wat wel verandert, is de tijd die nodig is om toegang te krijgen tot informatie. Een systeem in natuurlijke taal raadplegen in plaats van door mappenbomen te navigeren, een gestructureerd antwoord ontvangen in plaats van een lijst met resultaten, een gereconstrueerde bedrijfsregel lezen in plaats van vierhonderd regels met voorwaarden – de tijd die nodig is om toegang te krijgen tot informatie verandert met een orde van grootte voor een activiteit die een aanzienlijk deel van de werkdag in beslag neemt.

Deze tijdwinst maakt ook mogelijk wat altijd al de beste bescherming tegen fouten is geweest: kruiscontrole. Het vergelijken van de code, een ticket en een architectuurnota is een reflex die iedereen kent, maar die bijna niemand in de praktijk brengt, omdat het een onevenredige inspanning vergt in verhouding tot de vraag die aan de orde is. Wanneer dit wordt geautomatiseerd, wordt het een routinehandeling, en vormen afwijkingen tussen de bronnen zelf waardevolle informatie, die aangeeft waar de documentatie niet meer synchroon loopt met het daadwerkelijke systeem.

Er blijven twee kanttekeningen over.
Het eerste betreft de aard van wat toegankelijk is: afwegingen, historische beperkingen en architecturale beslissingen blijven stilzwijgend verborgen bij individuen en kunnen uit geen enkel archief worden gehaald.
Het tweede betreft de vorm van de verkregen antwoorden: een vloeiend en goed gestructureerd antwoord wekt meer vertrouwen dan de aarzeling van een collega. Traceerbaarheid terug naar de bron wordt een noodzaak, waardoor de lezer hetzelfde oordeel kan vellen dat hij, zonder het zich te realiseren, toepast op de antwoorden van een collega.

Het eerste kan uit geen enkele bron worden gehaald. Het tweede vloeit voort uit de vorm van de verkregen antwoorden: een vloeiend, goed opgebouwd antwoord wekt meer vertrouwen dan de aarzeling van een collega. Traceerbaarheid naar de bron wordt een noodzaak; het stelt de lezer in staat hetzelfde oordeel te vellen dat hij, zonder erbij na te denken, ook op de antwoorden van een collega toepast.

Op weg naar levende documentatie

Documentatie is pas ‘levend’ als ze een bijproduct van het systeem is in plaats van een losstaand artefact, als afwijkingen automatisch worden opgespoord en als we afspreken om alleen datgene te documenteren wat een reëel bedrijfsrisico vormt. Het produceren van tienduizend pagina’s die niemand zal lezen, zou op grotere schaal dezelfde mislukking betekenen als bij wiki’s.

Bij 5th floor implementeren we oplossingen die op deze aanpak zijn gebaseerd. Dit houdt in dat we eerst de kritieke reikwijdte vaststellen – de processen en componenten waarvan een gebrek aan inzicht een reëel risico zou vormen voor de bedrijfscontinuïteit, de omzet of de naleving van regelgeving – en vervolgens een basisdocumentatie opbouwen op basis van bestaande bronnen (code, tickets, notities, communicatie), in plaats van vanaf een leeg blad te beginnen. Deze basis wordt vervolgens doorzoekbaar gemaakt met behulp van natuurlijke taal, waarbij bronnen systematisch worden vermeld, en bij elke systeemupdate wordt de kruiscontrole geautomatiseerd, zodat afwijkingen worden gesignaleerd voordat een lezer ze ontdekt.

Bijdragers

Klinkt dit je bekend in de oren?

Elke organisatie heeft haar eigen context, beperkingen en tempo. Laten we het eens over die van u hebben. Een gesprek van een uur is vaak voldoende om de eerste aanknopingspunten in kaart te brengen.

Onze nieuwste publicaties