[billfruit]

Thats true, but at least before implementation, the behaviour to be implemented should be known to some extent. UML Statecharts remain a good method to document behaviour.

[ajuc]

Documenting implementation details is often exactly what you don't want.