Return-Path: 
 <forrest-dev-return-2181-apmail-xml-forrest-dev-archive=xml.apache.org@xml.apache.org>
Delivered-To: apmail-xml-forrest-dev-archive@xml.apache.org
Received: (qmail 57453 invoked by uid 500); 7 Aug 2002 22:57:41 -0000
Mailing-List: contact forrest-dev-help@xml.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:forrest-dev-help@xml.apache.org>
list-unsubscribe: <mailto:forrest-dev-unsubscribe@xml.apache.org>
list-post: <mailto:forrest-dev@xml.apache.org>
Reply-To: forrest-dev@xml.apache.org
Delivered-To: mailing list forrest-dev@xml.apache.org
Received: (qmail 57444 invoked from network); 7 Aug 2002 22:57:41 -0000
Received: from pcow034o.blueyonder.co.uk (HELO blueyonder.co.uk)
 (195.188.53.122)
  by daedalus.apache.org with SMTP; 7 Aug 2002 22:57:41 -0000
Received: from pcow034o.blueyonder.co.uk ([127.0.0.1]) by blueyonder.co.uk
  with Microsoft SMTPSVC(5.5.1877.757.75);
	 Wed, 7 Aug 2002 23:57:47 +0100
Received: from blueyonder.co.uk (unverified [80.195.77.87]) by
 pcow034o.blueyonder.co.uk
 (Content Technologies SMTPRS 4.2.9) with ESMTP id
 <T5c938fd143ac1785ec19f@pcow034o.blueyonder.co.uk> for
 <forrest-dev@xml.apache.org>;
 Wed, 7 Aug 2002 23:57:47 +0100
Message-ID: <3D51A5E9.4060102@blueyonder.co.uk>
Date: Wed, 07 Aug 2002 23:57:45 +0100
From: Ian Atkin <ianatkin@blueyonder.co.uk>
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US;
 rv:1.0.0) Gecko/20020530
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: forrest-dev@xml.apache.org
Subject: Re: [proposal] refactored markup help docs
References: <3D518E40.3070807@blueyonder.co.uk>
 <3D51978D.7030009@outerthought.org>
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N
Status: O
X-Status: 
X-Keywords: 



<snip>

>>
>
> "tab" I presume? 

no, just a clump of page like the howto's, something like:-

{docroot}/markup/index.html
{docroot}/markup/design.html
{docroot}/markup/document-v11/
{docroot}/markup/faq-v11/

or similar

<snip>

>
> every element might perhaps overdo it 

yeah, i've thought similar but my reasoning is:-
- alphabetical menu listing provides better access then a document toc
- plenty of space for descriptions, examples via <source>s, proposed 
changes in next versions (as well as content model, attributes, parents) etc

must confess this is more than a little inspired by the docbook guides :-)

<snip>

>
> feel free - even if it is hacky


firstly i did an Ant build-time approach, making typical forrest xdocs
- using multi-doc output in an xslt script, and using document() to load 
in hand written text
- this seems a total hack, not in the cocoon spirit at all

then i forced the thing into the sitemap processing, got following issues:-
- parsing full document dtdxflat file for menu & every element (is this 
cached? or is just the generator not recycled?)
- the book-cocoon & tab-cocoon dtd filenames conflict with the sitemap 
matching and i'm not up to speed with matchers to get round it
- hacked it using rough aggregation, but i'm thinking xinclude 
transformer might be better (any performance differences?)

now i'm thinking that whole point of these doctypes is that they change 
slowly and carefully - does this need to be dynamic after all?

seeing as the doctype issues are more political, i'll write them up 
after re-reading archives and raise one issue per mail, just one 
question first:-
- are any changes planned in near future (linking elements, xhtml 
refactor, etc)
- you've said main forrest aim is doctype version control, how will 
markup be changed? by in/formal vote?

when i've got something in a decent state i'll plonk it somewhere 
visible for folks to see what i'm on about