Python from Wise Guy's Viewpoint

Fergus Henderson fjh at cs.mu.oz.au
Tue Nov 11 10:29:59 EST 2003


Pascal Costanza <costanza at web.de> writes:

>b) documentation
>
>Documentation can be handled well with comments and well-chosen names.

Certainly it _can_ be, but keeping good, up-to-date documentation is a
difficult task.  In my experience, average programmers do a better job
of documentation in languages which encourage explicitly declaring the
types of interfaces than in those which do not.

-- 
Fergus Henderson <fjh at cs.mu.oz.au>  |  "I have always known that the pursuit
The University of Melbourne         |  of excellence is a lethal habit"
WWW: <http://www.cs.mu.oz.au/~fjh>  |     -- the last words of T. S. Garp.




More information about the Python-list mailing list