Du koder, BDoc dokumenterer

Per Otto Bergum Christensen har laget et meget spennende åpen kildekode verktøy, BDoc, som jeg har veldig tro på kan bli veldig nyttig fremover. Jeg så lyntalen om BDoc på Smidig 2008 og det gjorde meg enda mer nyskjerrig på hvordan BDoc kunne hjelpe meg.
BDoc hjelper utvikler team til å holde bruker historier (eller user stories på norsk) synkronisert med test koden på en bedre måte enn tidligere. BDoc genrerer rapporter på et naturlig språk utifra testkoden til utviklerne. Dette gjør at hvem som helst kan lese hvilke krav som er implementert av utvikleren. Rapportene er lenket opp mot bruker historier og dette gjør at man unngår det klassiske problemet med at disse to viktige delene ikke stemmer over ens og at man bruker mye tid på å samkjøre disse.

BDoc er i første versjon og det er et par åpenbare ting som vil gjøre det enda bedre, likevel er fordelene såpass store slik at det er bare å begynne bruke det umiddelbart også eventuelt bidra selv med kode til å tilpasse BDoc slikat det passer dine behov. Jeg kunne blant annet tenkt meg muligheten til å referere til bruker historiene med en link, slik at man kan ha disse i en Wiki eller lignende. Da kan man bruke mange ulike link sjekk programmer til å unngå døde linker og slike ting.

BDoc har begynt å få en del oppmerksomhet i utvikler kretser og denne uken ble det publisert en artikkel på The Server Side som gir en grundig innføring i BDoc og hvordan det fungerer.