Return-Path: Delivered-To: apmail-cocoon-dev-archive@www.apache.org Received: (qmail 56633 invoked from network); 12 Oct 2005 03:36:29 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 12 Oct 2005 03:36:29 -0000 Received: (qmail 98808 invoked by uid 500); 12 Oct 2005 03:36:27 -0000 Delivered-To: apmail-cocoon-dev-archive@cocoon.apache.org Received: (qmail 98750 invoked by uid 500); 12 Oct 2005 03:36:27 -0000 Mailing-List: contact dev-help@cocoon.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Reply-To: dev@cocoon.apache.org List-Id: Delivered-To: mailing list dev@cocoon.apache.org Received: (qmail 98739 invoked by uid 99); 12 Oct 2005 03:36:26 -0000 Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 11 Oct 2005 20:36:26 -0700 X-ASF-Spam-Status: No, hits=0.0 required=10.0 tests= X-Spam-Check-By: apache.org Received-SPF: neutral (asf.osuosl.org: local policy) Received: from [68.230.240.34] (HELO eastrmmtao05.cox.net) (68.230.240.34) by apache.org (qpsmtpd/0.29) with ESMTP; Tue, 11 Oct 2005 20:36:28 -0700 Received: from [192.168.0.100] (really [70.179.64.83]) by eastrmmtao05.cox.net (InterMail vM.6.01.05.02 201-2131-123-102-20050715) with ESMTP id <20051012033603.EBUB28234.eastrmmtao05.cox.net@[192.168.0.100]> for ; Tue, 11 Oct 2005 23:36:03 -0400 Message-ID: <434C84A5.6090008@reverycodes.com> Date: Tue, 11 Oct 2005 23:36:05 -0400 From: Vadim Gritsenko User-Agent: Mozilla Thunderbird 1.0.6 (Windows/20050716) X-Accept-Language: en-us, en MIME-Version: 1.0 To: dev@cocoon.apache.org Subject: Re: [RT] Is Cocoon Obsolete? References: <433EF6D4.6040209@apache.org> <20051002014142.9A7A926D13B@avs2.arnes.si> <434C7C97.2080107@reverycodes.com> <434C8020.40403@apache.org> In-Reply-To: <434C8020.40403@apache.org> Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N Stefano Mazzocchi wrote: > *my* problem is http://cocoon.apache.org/2.1/apidocs/ > > Look at it... it's a monster... it includes *everything*. A javadoc is > useless if it's too big to be used as a reference. Isn't it *meant* to include everything? Isn't it the root idea of javadoc? Personally I'd also link source code from there, but may be it's just me :-) > Some of that stuff is meant to be used by developers using cocoon as a > framework and some by developers developing cocoon itself. > > Not only, APIs are here and there, some in avalon, some in excalibur... > great to see them linked together, but it would be even better if they > were all in one place, with the same look and feel and with a single > page to show all you have to know. Similar thread pops up very regularly... I recall at least two threads on infrastructure@ about setting up some uber-doc system. In addition, there are more than one projects going on outside of apache as well... > I think a better, leaner, cleaner javadoc would go a *LOOOONG* way to > make things easier. It might - I don't know what users are looking for... Vadim