[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Tests, Documentation

From: Patrik Reali
Subject: Re: Tests, Documentation
Date: Sun, 23 Nov 2003 13:42:42 +0100

Hi Sascha,

I completely agree and support your wishes! In fact, it would be nice if the
whole classpath and its documentation (javadoc) would be rebuilt on a
regular base and offered through the website.

I disagree on one point: testing doesn't slow down development. It may be
boring, but it is like a safety net that prevents developers from comitting
buggy code and allow to detect errors early (and thus much faster) when they
are inserted.

Patrik Reali

> Dear co-hackers,
> having read quite a bit of Classpath code, I'd like to express two wishes.
> First, please write more test cases. I agree that it is boring, dumb, and
> taxing; testing slows down development. But it's also the most reliable
> way to make sure that code really works. If anyone needs to change our
> code in five years, they'll want to know whether their change has any
> serious impact. Without a large test suite, this is close to impossible.
> Second, please write understandable documentation for every single
> method. Developers should be able to create free programs without
> referring to external documents. These could disappear at any time.
> In other words, I think that we really need to improve the quality of our
> code. Building a sound foundation for others is not the same as some fun
> week-end hack.
> Thank you all,
> -- Sascha
> Sascha Brawer, address@hidden,
> _______________________________________________
> Classpath mailing list
> address@hidden

reply via email to

[Prev in Thread] Current Thread [Next in Thread]