Diagram over XAL kode?

De gange, hvor jeg har lavet dokumentation, har det været funktionsbeskrivelser og relationsdiagrammer, hvor selve koden så er vedlagt som bilag. Funktionsbeskrivelserne har så været meget detaljeret, både hvad de skulle kunne og hvad der ikke skal/kan ske.
I mit tidligere job var beskrivelserne grundlaget for koden, ikke omvendt. Derfor var det ikke koden, der blev beskrevet, men funktionerne herunder parametre, fejlkoder mv. Når koden så var afsluttet, blev den udskrevet som bilag. Det gav en hulens masse arbejde med at vedligeholde dokumentationen, fordi selv minimale ændringer afstedkom et nyt sæt beskrivelse og et nyt bilag med koden.
Hvis formålet med dokumentation er, at andre senere skal kunne forstå hvad der er lavet og hvordan det hænger sammen, så er en god, overordnet beskrivelse meget bedre, især i kombination med en liste over elementerne.
Sidder og tænker på hvornår jeg har brug for at vide om en stump kode ligger i en localmacro, generel macro eller blot er liniært programmeret? Aldrig - jeg ser i koden, hvis jeg skal ændre i den. Der vil jeg til gengæld gerne se lidt grøn tekst, velvalgt placeret.
Det hjælper dig ikke meget, hvis du absolut vil lave diagrammer over en xal-kørsel. Jeg kender ikke til nogen, der har dokumenteret med diagrammer, kun som nævnt beskrivelser.

Jeg endte med at gå i tænkeboks, og tegne lidt i Visio.