ICT Knowledge Hub Terugblik: Working Documentation over Comprehensive Confusion

De avond werd bezocht door een kleine 20 mensen. De sessie was gegoten in een vraag-en-antwoordformat, waarbij alle aanwezigen enthousiast hun bijdrage leverden, met een hoop rake inzichten:

• Incorrecte of ontbrekende kennis is de grootste bron van problemen, vertragingen en frustraties in ons dagelijks werk.
• Naarmate kennis binnen een organisatie verloren raakt, worden organisaties steeds conservatiever in hoe zij hun product aanpassen en onderhouden.
• Het onderhouden van bestaande documentatie wordt vaak verwaarloosd. Dit maakt documenten steeds onbetrouwbaarder, totdat we de documentatie niet meer vertrouwen en haar als "onbruikbaar" beschouwen.
• We integreren kennisborging en kennisdeling vaak op onbehulpzame manieren: van zinloze procesbevrediging tot documentatie-anarchie, maar zelden met een doelgerichte visie op het wat en waarom.
• Het proces van kennis borgen en kennis delen wordt vaak gefrustreerd door logge, ge?soleerde en versnipperde kennissystemen.

Gelukkig bracht de avond ook een visie op hoe het beter kan. Johan van Berkel deelde zijn inzicht in hoe Behavior Driven Development heel bewust het opbouwen en borgen van kennis cultiveert, op een manier die daadwerkelijk aansluit bij het Agile Manifesto. Het systematisch uitwerken van gewenst gedrag, van klantdoel tot implementatie, het borgen van gedeeld begrip en taal via de "Three Amigos" en het beschrijven van systeemgedrag als "executable specifications" zorgen ervoor dat kenniscreatie en -borging waardevol en volledig geïntegreerd zijn in de complete product lifecycle.

De avond sloot af met een mogelijk antwoord op de laatste vraag: hoe we het beheer, onderhoud en de publicatie van documentatie zelf zo laagdrempelig mogelijk kunnen maken. De bezoekers kregen een live demonstratie die de draad oppakt waar Behavior Driven Development die laat vallen. Door documentatie te integreren in code repositories kunnen we niet alleen documentatie beheren als code, maar ook decenniaoude technologie gebruiken voor het automatisch publiceren van kennis als websites, met alle mogelijkheden en het gebruikersgemak die daarbij komen kijken.

Wil je meer weten over de Living Documentation-tool? Neem contact op met Johan van Berkel en/of lees hier zijn artikel op LinkedIn over de hoe het tool is ontstaan.