De slechtste WBSO-documentatie wordt geschreven in de drie weken voor de aanvraagdeadline, waarbij wordt gereconstrueerd wat er de afgelopen vier maanden is gebeurd vanuit geheugen, commitgeschiedenissen en agendavermeldingen. De beste WBSO-documentatie wordt geschreven terwijl het O&O plaatsvindt, met realtime vastlegging van technische vragen, experimentresultaten en de redenering achter aanpakwijzigingen.
Waarom engineeringteams niet van nature documenteren
Engineers documenteren uitkomsten — code, ontwerpen, specificaties — niet processen. De redenering achter technische beslissingen, de aanpakken die niet werkten, de specifieke vragen die werden onderzocht en opgelost: deze verdwijnen in het geheugen tenzij er een bewuste praktijk is om ze vast te leggen. WBSO vereist precies dit soort procesdocumentatie. Het bouwen van die gewoonte vereist het veranderen van wat teams vastleggen, niet alleen wanneer ze het vastleggen.
De documentatie die er toe doet voor WBSO
Drie categorieën documentatie zijn het meest waardevol voor WBSO-compliance. Ten eerste onderzoeksvragen: welke technische vraag wordt onderzocht, waarom is het onzeker en welke aanpakken worden geprobeerd. Ten tweede experimentregistraties: wat werd geprobeerd, wat het resultaat was en wat het resultaat betekent voor de onderzoeksvraag. Ten derde beslissingsredenering: wanneer een aanpak wordt gewijzigd of een technische beslissing wordt genomen, waarom — vooral wanneer een eerdere aanpak faalde.
- Onderzoeklogs: één invoer per onderzoeksessie, wat werd geprobeerd en wat werd geleerd
- Experimentregistratie: hypothesen, parameters, resultaten, conclusies
- Technische beslissingsregistraties: waarom een aanpak werd aangenomen, waarom een alternatief werd verworpen
- Wekelijkse samenvattingen: per engineer, welke kwalificerende O&O-activiteiten vonden deze week plaats
Het deel uitmaken van de werkstroom
Documentatiegewoonten beklijven wanneer ze geïntegreerd zijn in bestaande werkstromen, niet als afzonderlijke taken worden toegevoegd. Als je team sprintreviews doet, voeg dan een slot van vijf minuten toe waarbij engineers de technische vragen noteren die tijdens de sprint zijn onderzocht en wat is geleerd.
De rol van de manager
Documentatiecultuur begint bij wat de O&D-manager vraagt in teamvergaderingen. Als elke technische discussie begint met "wat is de onderzoeksvraag?" en eindigt met "wat hebben we erover geleerd?", internaliseren engineers die kadrering. De nieuwsgierigheid van de O&O-manager naar technische onzekerheid is de primaire drijfveer voor het documenteren ervan door het team.
Klaar om je concurrenten te volgen?
WBSO.io monitort automatisch websites, e-mails en social media van je concurrenten — en levert gestructureerde intelligence rechtstreeks in je inbox.