From: David Vallner <david@...>
Date: 2006-10-23T07:14:09+09:00
Subject: Re: [OT:usage of uml]

--------------enig42E902B9FCAE1A7ECB2737CF
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable

Chris Carter wrote:
> Our team does believe in Agile and XP
> design concepts, so we do a lot of testing, and speccing, which we feel=

> better documents our code than UML.

And here I thought programming was an engineering discipline, and not a
religious practice. (If you confuse those two, Picocontainer happens.
/me ducks rotten vegetables.)

Also, make sure you don't forget the audience of your code and
documentation. You shouldn't document the code how you feel it's better,
but how whoever will have to read the documentation (to maintain the
code after your team moved on to greener pastures) can understand it
better Believe it or not, these things just might be different - from
the code author's point of view it can be hard to ascertain if
documentation is sufficient since you know what the code is doing /
supposed to do already. (<helen-lovejoy>Won't somebody PLEASE think of
the end users?</helen-lovejoy>)

David Vallner


--------------enig42E902B9FCAE1A7ECB2737CF
Content-Type: application/pgp-signature; name="signature.asc"
Content-Description: OpenPGP digital signature
Content-Disposition: attachment; filename="signature.asc"

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.5 (MingW32)

iD8DBQFFO+0wy6MhrS8astoRAq2fAJ4vMmNzPqEBz6K0MSTUOjfjxyO8swCeJ2hr
bJj2uKt0Su8Qk3RHqNwLaCI=
=8Gcd
-----END PGP SIGNATURE-----

--------------enig42E902B9FCAE1A7ECB2737CF--