Return-Path: Delivered-To: apmail-jakarta-commons-dev-archive@apache.org Received: (qmail 58476 invoked from network); 7 Jan 2002 17:06:04 -0000 Received: from unknown (HELO nagoya.betaversion.org) (192.18.49.131) by daedalus.apache.org with SMTP; 7 Jan 2002 17:06:04 -0000 Received: (qmail 292 invoked by uid 97); 7 Jan 2002 17:06:03 -0000 Delivered-To: qmlist-jakarta-archive-commons-dev@jakarta.apache.org Received: (qmail 239 invoked by uid 97); 7 Jan 2002 17:06:02 -0000 Mailing-List: contact commons-dev-help@jakarta.apache.org; run by ezmlm Precedence: bulk List-Unsubscribe: List-Subscribe: List-Help: List-Post: List-Id: "Jakarta Commons Developers List" Reply-To: "Jakarta Commons Developers List" Delivered-To: mailing list commons-dev@jakarta.apache.org Received: (qmail 221 invoked from network); 7 Jan 2002 17:06:02 -0000 content-class: urn:content-classes:message MIME-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" Content-Transfer-Encoding: quoted-printable Subject: RE: Commons Validator Packaging/Content X-MimeOLE: Produced By Microsoft Exchange V6.0.4712.0 Date: Mon, 7 Jan 2002 18:06:24 +0100 Message-ID: X-MS-Has-Attach: X-MS-TNEF-Correlator: Thread-Topic: Commons Validator Packaging/Content Thread-Index: AcGXnIWZga12I+QzRvGn8YtE2t4FlgAABqFw From: "Tom Klaasen (TeleRelay)" To: "Jakarta Commons Developers List" X-OriginalArrivalTime: 07 Jan 2002 17:06:00.0127 (UTC) FILETIME=[9490ECF0:01C1979D] X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N > -----Original Message----- > From: Jon Scott Stevens [mailto:jon@latchkey.com]=20 > Sent: maandag 7 januari 2002 17:58 > To: Jakarta Commons Developers List > Subject: Re: Commons Validator Packaging/Content >=20 >=20 > on 1/7/02 8:50 AM, "Tom Klaasen (TeleRelay)"=20 > > wrote: >=20 > > Are you sure about this? I've got the impression struts has=20 > more users > > than developers (as has Cocoon, but that isn't jakarta strictly > > speaking) >=20 > I wasn't talking about those projects. You were talking about "jakarta", weren't you? > >> If we had more=20 > >> users who > >> turned into developers, we might have more documentation. > >=20 > > Again I'm not sure about this. The user who is learning=20 > some project is > > not able to write documentation, and the user who becomes a=20 > developer > > wants to develop, since his need for documentation is=20 > reduced (less itch > > to scratch). >=20 > Actually, a lot of users tend to document things when they are first > learning something new. ... just to see that they got the details wrong, and discard their effort as "useless". That's what happened to me, anyway. Documentation has to be written by developers, not by users. Just as there seems to be a tendency to "testing has to be done by developers, not by users" (cf. all the automated tests I see appear in diverse projects). Maybe it is time for a JDoc project, which causes builds to fail unless there's enough documentation ;-) Anyway, voting "-1" on something to say "you have to take mine, not yours" is euhm... not constructive for dialog and cooperation IMHO. tomK -- To unsubscribe, e-mail: For additional commands, e-mail: