From dev-return-72169-apmail-cocoon-dev-archive=cocoon.apache.org@cocoon.apache.org Fri Mar 11 00:28:44 2005 Return-Path: Delivered-To: apmail-cocoon-dev-archive@www.apache.org Received: (qmail 97692 invoked from network); 11 Mar 2005 00:28:42 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur-2.apache.org with SMTP; 11 Mar 2005 00:28:42 -0000 Received: (qmail 99615 invoked by uid 500); 11 Mar 2005 00:28:39 -0000 Delivered-To: apmail-cocoon-dev-archive@cocoon.apache.org Received: (qmail 99565 invoked by uid 500); 11 Mar 2005 00:28:39 -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 Delivered-To: mailing list dev@cocoon.apache.org Received: (qmail 99551 invoked by uid 99); 11 Mar 2005 00:28:39 -0000 X-ASF-Spam-Status: No, hits=0.0 required=10.0 tests= X-Spam-Check-By: apache.org Received-SPF: neutral (hermes.apache.org: local policy) Received: from www2.kc.aoindustries.com (HELO www2.kc.aoindustries.com) (65.77.211.84) by apache.org (qpsmtpd/0.28) with ESMTP; Thu, 10 Mar 2005 16:28:38 -0800 Received: from www2.kc.aoindustries.com (www2.kc.aoindustries.com [65.77.211.84]) by www2.kc.aoindustries.com (8.12.9-20030917/8.12.9) with ESMTP id j2B0SZYS014995 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO) for ; Thu, 10 Mar 2005 18:28:35 -0600 Received: from localhost (localhost [[UNIX: localhost]]) by www2.kc.aoindustries.com (8.12.9-20030917/8.12.9/Submit) id j2B0SZlf014962 for dev@cocoon.apache.org; Thu, 10 Mar 2005 18:28:35 -0600 X-Authentication-Warning: www2.kc.aoindustries.com: indexgeo set sender to crossley@apache.org using -f Date: Fri, 11 Mar 2005 11:28:24 +1100 From: David Crossley To: dev@cocoon.apache.org Subject: Re: [docs] "docs" Ant target Message-ID: <20050311002824.GA7246@igg.indexgeo.com.au> References: <42262E1D.70109@apache.org> <20050303062333.GA554@igpb.indexgeo.com> <4226C49C.8040305@apache.org> <20050304010942.GA2462@igpb.indexgeo.com> <42281BAA.9070101@apache.org> <20050309053450.GA5256@igg.indexgeo.com.au> <422F32C2.6080806@apache.org> <20050310061808.GA6678@igg.indexgeo.com.au> <422FED37.1010902@apache.org> <423025AA.10208@upaya.co.uk> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <423025AA.10208@upaya.co.uk> User-Agent: Mutt/1.4i X-Virus-Checked: Checked X-Spam-Rating: minotaur-2.apache.org 1.6.2 0/1000/N Upayavira wrote: > Reinhard Poetz wrote: > >David Crossley wrote: > > > >>The other thing to bear in mind, and this was one of the big hold-ups > >>in the past with improving the docs, is that all of the docs are also > >>generated via the Cocoon webapp ... 'cocoon.sh servlet'. They use old > >>stylesheets that are probably dependent on an old version of xdocs DTD. > >>I don't have any answer to that. > > > >I don't think we need this anymore. "forrest webapp" is more than a > >replacement for people who want to see the docs "live". > > Well, I really _don't_ like the idea of not shipping HTML docs with a > distribution, whether that is shipping ready made HTML, or as viewable > via Cocoon. Telling a beginner who wants to read the docs offline that > he has to go and download Forrest to find out how Cocoon works is just > not acceptable. I agree with Upayavira. A smart framework like Cocoon should be able to render its own docs, even if with no trimmings and just a flat navigation menu down the left-hand side. --David