From java-dev-return-19871-apmail-lucene-java-dev-archive=lucene.apache.org@lucene.apache.org Thu May 31 07:11:50 2007 Return-Path: Delivered-To: apmail-lucene-java-dev-archive@www.apache.org Received: (qmail 41069 invoked from network); 31 May 2007 07:11:47 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.2) by minotaur.apache.org with SMTP; 31 May 2007 07:11:47 -0000 Received: (qmail 78669 invoked by uid 500); 31 May 2007 07:11:48 -0000 Delivered-To: apmail-lucene-java-dev-archive@lucene.apache.org Received: (qmail 78629 invoked by uid 500); 31 May 2007 07:11:48 -0000 Mailing-List: contact java-dev-help@lucene.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: java-dev@lucene.apache.org Delivered-To: mailing list java-dev@lucene.apache.org Received: (qmail 78614 invoked by uid 99); 31 May 2007 07:11:48 -0000 Received: from herse.apache.org (HELO herse.apache.org) (140.211.11.133) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 31 May 2007 00:11:48 -0700 X-ASF-Spam-Status: No, hits=-0.0 required=10.0 tests=SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (herse.apache.org: domain of DORONC@il.ibm.com designates 195.212.29.155 as permitted sender) Received: from [195.212.29.155] (HELO mtagate6.de.ibm.com) (195.212.29.155) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 31 May 2007 00:11:42 -0700 Received: from d12nrmr1607.megacenter.de.ibm.com (d12nrmr1607.megacenter.de.ibm.com [9.149.167.49]) by mtagate6.de.ibm.com (8.13.8/8.13.8) with ESMTP id l4V7BLNG545494 for ; Thu, 31 May 2007 07:11:21 GMT Received: from d12av04.megacenter.de.ibm.com (d12av04.megacenter.de.ibm.com [9.149.165.229]) by d12nrmr1607.megacenter.de.ibm.com (8.13.8/8.13.8/NCO v8.3) with ESMTP id l4V7BKgt4014168 for ; Thu, 31 May 2007 09:11:20 +0200 Received: from d12av04.megacenter.de.ibm.com (loopback [127.0.0.1]) by d12av04.megacenter.de.ibm.com (8.12.11.20060308/8.13.3) with ESMTP id l4V7BKmQ002398 for ; Thu, 31 May 2007 09:11:20 +0200 Received: from d12mc102.megacenter.de.ibm.com (d12mc102.megacenter.de.ibm.com [9.149.167.114]) by d12av04.megacenter.de.ibm.com (8.12.11.20060308/8.12.11) with ESMTP id l4V7BKwF002391 for ; Thu, 31 May 2007 09:11:20 +0200 In-Reply-To: <200705310857.47810.paul.elschot@xs4all.nl> Subject: Re: Documentation Brainstorming To: java-dev@lucene.apache.org X-Mailer: Lotus Notes Release 7.0 HF277 June 21, 2006 Message-ID: From: Doron Cohen Date: Thu, 31 May 2007 00:07:59 -0700 X-MIMETrack: Serialize by Router on D12MC102/12/M/IBM(Release 7.0.2HF71 | November 3, 2006) at 31/05/2007 10:11:19 MIME-Version: 1.0 Content-type: text/plain; charset=US-ASCII X-Virus-Checked: Checked by ClamAV on apache.org Paul Elschot wrote on 30/05/2007 23:57:47: > On Thursday 31 May 2007 05:52, Erik Hatcher wrote: > > > > On May 30, 2007, at 9:33 PM, Grant Ingersoll wrote: > > >> I'd rather see each jar get its own javadoc, > > >> or at the very least, indicate which jar each > > >> class is defined in for the ones that aren't > > >> part of the core. > > >> > > > > > > Yeah, I don't like that all the contribs are built in together. > > > What do others think? I would vote for separating them out. > > > > I concur with having the contrib docs separated. I may have been the > > one (or at least assisted with it) who got the documentation build to > > fold it altogether as that was the goal at the time. It'd be much > > easier, build-wise, if all artifacts were kept entirely separate for > > all the various contrib libraries and the core, as well as the demo. > > > Currently it is not clear in the javadocs whether a class belongs > to core or contrib. Having separate javadocs would probably > improve that. > I have no experience in linking between javadoc "packages", > so I have no suggestion on how to make such a separation. I am all for separation. Though it is sometimes useful to have it all together, - perhaps two versions: all, and by module (core, contrib/x, contrib/y, etc.)? Or is this too cluttered - we already have it by release... --------------------------------------------------------------------- To unsubscribe, e-mail: java-dev-unsubscribe@lucene.apache.org For additional commands, e-mail: java-dev-help@lucene.apache.org