Rafal Krzewski <[EMAIL PROTECTED]> writes:
>Henning P. Schmiedehausen wrote:
>> Is "documentation" one of the 2-3 serious things left to do?
>Documentation is nice but working code is better :-) My experience with
>OSS shows that docs lie on the far end of the priority list. The people
And that's why there are bazillons of abandoned, half-finished or
simply not usable OSS projects.
And patches for projects that make you wanna cry because the
contributor of the patch didn't have a chance to understand the basic
idea of a project and when he asked, noone answered and 10.000 lines
of tightly written foo-Code contained four lines of comments.
I do hate this "the code is the documentation" attitude. :-)
I'd be very sad seeing something which shaping up quite nicely like
maven going down the drain because noone understands its abilities or
even knows about some configuration options. Reading the source is in
a time-pressure environment sometimes simply not possible.
ant e.g. is widely accepted because there are lots of really good and
comprehensible documentation. But then again, it looks like someone
actually paid for to get it written.
Regards
Henning
--
Dipl.-Inf. (Univ.) Henning P. Schmiedehausen -- Geschaeftsfuehrer
INTERMETA - Gesellschaft fuer Mehrwertdienste mbH [EMAIL PROTECTED]
Am Schwabachgrund 22 Fon.: 09131 / 50654-0 [EMAIL PROTECTED]
D-91054 Buckenhof Fax.: 09131 / 50654-20
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
