From conor@cortexebusiness.com.au Tue Feb 6 14:51:27 2001 Return-Path: Mailing-List: contact ant-dev-help@jakarta.apache.org; run by ezmlm Delivered-To: mailing list ant-dev@jakarta.apache.org Received: (qmail 84440 invoked from network); 6 Feb 2001 14:51:27 -0000 Received: from mta05.mail.au.uu.net (HELO mta05.mail.mel.aone.net.au) (203.2.192.85) by h31.sny.collab.net with SMTP; 6 Feb 2001 14:51:27 -0000 Received: from cognetnt ([63.34.224.9]) by mta05.mail.mel.aone.net.au with SMTP id <20010206145124.VZLZ6342.mta05.mail.mel.aone.net.au@cognetnt> for ; Wed, 7 Feb 2001 01:51:24 +1100 Message-ID: <03ef01c0904c$81ec5fc0$c6e2223f@cognetnt> From: "Conor MacNeill" To: References: <041501c08f7b$e2868530$c2950c3f@cognetnt> <3A7EC206.4FFD4329@netbeans.com> <03a901c09049$51927920$c6e2223f@cognetnt> <3A800C90.F77E1949@somanetworks.com> Subject: Re: New manual organization Date: Wed, 7 Feb 2001 01:52:59 +1100 MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 5.50.4522.1200 X-MimeOLE: Produced By Microsoft MimeOLE V5.50.4522.1200 X-Spam-Rating: h31.sny.collab.net 1.6.2 0/1000/N Glenn, From: "Glenn McAllister" > > I think we all agreed last release that we needed something better, like > Anakia or stylebook or whatever. The stopper was we wanted to have pluggable, > per task docs that came from their pluggin jars (a la Ant 2). Still a good idea. > > Seeing as something like this was I wanted for the 1.2 release, I'm certainly > not going to object. :-) My only comment is that you probably do want to > break out the optional task docs as well. With them still living in the main > index.html, its a little confusing as to why you don't get bumped out the same > way you do with the core tasks. Yep, absolutely. There are these issues and a number of things that would need to be fixed: task to task links, links to other parts of the old index.html, etc. This was just a proof of concept thing. I didn't want to put in more effort than was necessary to show the idea. The documentation file per task feels right. > Also, you need a link back from the index of > tasks to the main page (or one on each content page, but thats harder to > maintain). > OK, good idea. Conor