[Sigia-l] Elements of Documentation

[Lord, Ralph]

Ziya wrote:
 
> People who have no understanding of the intricacies of code 
> writing should
> not be in the business of showing/telling programmers what to do. The
> prototype should show WHAT to do. The programmers should 
> deconstruct it to
> figure out HOW to do it in code. Mixing the two is asking for trouble.

>when I see UML charts done by IAs , business analysts, project
>managers, GUI architects, etc., with method descriptions, classes, global
>variables, etc....

Couldn't agree more.  Generally makes for more productive and happier teams.
None of this "Your chocolate's in my peanut butter - your peanut butter's in
my chocolate" infighting when spheres of expertise are invaded.  Besides, if
you really want to spend all your time deciding HOW the app should be
implemented, you ought to be getting paid to program. I, personally, for
one, my own self, am more than happy to help clients figure out WHAT the
app/site/X should do and leave it up to the inscrutable ;-) developers to
make it work.