Recommended resources:
Literate Modelling -- Capturing Business Knowledge with the UML
/ Jim Arlow + Wolfgang Emmerich + John Quinn,
University College London; 11pp.
They found UML lacks in understandability, and doesn't integrate well enough with the rest of their code (in other languages, ie, programming languages), and their obvious solution was... LiterateProgramming :o).