From dev-return-17779-apmail-forrest-dev-archive=forrest.apache.org@forrest.apache.org Fri Jul 08 21:54:27 2005 Return-Path: Delivered-To: apmail-forrest-dev-archive@www.apache.org Received: (qmail 29414 invoked from network); 8 Jul 2005 21:54:17 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 8 Jul 2005 21:54:17 -0000 Received: (qmail 85628 invoked by uid 500); 8 Jul 2005 21:54:15 -0000 Delivered-To: apmail-forrest-dev-archive@forrest.apache.org Received: (qmail 85590 invoked by uid 500); 8 Jul 2005 21:54:15 -0000 Mailing-List: contact dev-help@forrest.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Reply-To: dev@forrest.apache.org List-Id: Delivered-To: mailing list dev@forrest.apache.org Received: (qmail 85577 invoked by uid 99); 8 Jul 2005 21:54:14 -0000 Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 08 Jul 2005 14:54:14 -0700 X-ASF-Spam-Status: No, hits=0.0 required=10.0 tests= X-Spam-Check-By: apache.org Received-SPF: pass (asf.osuosl.org: local policy) Received: from [165.98.153.184] (HELO ags01.agsoftware.dnsalias.com) (165.98.153.184) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 08 Jul 2005 14:54:13 -0700 Received: from [10.0.0.7] (apoyo.agsoftware.dnsalias.com [10.0.0.7]) by ags01.agsoftware.dnsalias.com (8.13.1/8.13.1) with ESMTP id j68Lruuk005815 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Fri, 8 Jul 2005 16:53:59 -0500 Message-ID: <42CEF5F3.5020209@agssa.net> Date: Fri, 08 Jul 2005 16:53:55 -0500 From: Antonio Gallardo Organization: AG Software, S. A. User-Agent: Mozilla Thunderbird 1.0.2-6 (X11/20050513) X-Accept-Language: en-us, en MIME-Version: 1.0 To: dev@forrest.apache.org Subject: Re: Importance of Javadocs References: <42CE31E4.4000104@apache.org> <42CE3390.2070905@pcotech.fr> <42CE4E58.6010508@apache.org> <42CE5713.7030108@pcotech.fr> In-Reply-To: <42CE5713.7030108@pcotech.fr> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 8bit X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N Cyriaque Dupoirieux wrote: > Ross Gardler a écrit : > >> Cyriaque Dupoirieux wrote: >> >>> Ross Gardler a écrit : >>> >> >> ... >> >>>> It is my intention insist on patches having adequate Javadoc >>>> comments before I apply them. Is the community in general agreement >>>> here or am I being too draconian? >>> >>> >>> >>> >>> No you're not. >>> We can even consider to use maven to publish our documentation... >> >> >> >> I'm not familiar with Maven so help me out here. >> >> Why would we want to use Maven to publish our docs when Forrest is a >> framework for publishing docs? >> >> At some point I want to build a set of plugins for things like >> Javadocs etc. Should I be considering integration with Maven instead? >> If so, why? > > > If you want to rewrite plugs in already developed for Maven then there > is no need to use it. > But I am not sure it's usefull since maven already does it well ;-) We don need to rewrite code at all. Cocoon generates his own docos using qdox block - http://cocoon.zones.apache.org/demos/release/samples/blocks/qdox/welcome I am pretty sure we can use it in forrest or just build a plugin for that. ;-) Best Regards, Antonio Gallardo