Return-Path: 
 <dev-return-75373-apmail-cocoon-dev-archive=cocoon.apache.org@cocoon.apache.org>
Delivered-To: apmail-cocoon-dev-archive@www.apache.org
Received: (qmail 19403 invoked from network); 9 Jun 2005 14:54:30 -0000
Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199)
  by minotaur.apache.org with SMTP; 9 Jun 2005 14:54:30 -0000
Received: (qmail 13741 invoked by uid 500); 9 Jun 2005 14:54:23 -0000
Delivered-To: apmail-cocoon-dev-archive@cocoon.apache.org
Received: (qmail 13694 invoked by uid 500); 9 Jun 2005 14:54:23 -0000
Mailing-List: contact dev-help@cocoon.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:dev-help@cocoon.apache.org>
list-unsubscribe: <mailto:dev-unsubscribe@cocoon.apache.org>
List-Post: <mailto:dev@cocoon.apache.org>
Reply-To: dev@cocoon.apache.org
List-Id: <dev.cocoon.apache.org>
Delivered-To: mailing list dev@cocoon.apache.org
Received: (qmail 13680 invoked by uid 99); 9 Jun 2005 14:54:22 -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 euros.telenet-ops.be (HELO euros.telenet-ops.be)
 (195.130.132.55)
  by apache.org (qpsmtpd/0.28) with ESMTP; Thu, 09 Jun 2005 07:54:20 -0700
Received: from adicia.telenet-ops.be (adicia.telenet-ops.be [195.130.132.56])
	by euros.telenet-ops.be (Postfix) with ESMTP id 755A648E6B
	for <dev@cocoon.apache.org>; Thu,  9 Jun 2005 16:53:46 +0200 (MEST)
Received: from localhost (localhost.localdomain [127.0.0.1])
	by adicia.telenet-ops.be (Postfix) with SMTP id 6157544212
	for <dev@cocoon.apache.org>; Thu,  9 Jun 2005 16:53:36 +0200 (MEST)
Received: from [192.168.1.100] (dD5E0099B.access.telenet.be [213.224.9.155])
	by adicia.telenet-ops.be (Postfix) with ESMTP id F0C274420E
	for <dev@cocoon.apache.org>; Thu,  9 Jun 2005 16:53:35 +0200 (MEST)
Mime-Version: 1.0 (Apple Message framework v622)
In-Reply-To: <1333a88984878666ee81c283c1e4feca@efurbishment.com>
References: <1333a88984878666ee81c283c1e4feca@efurbishment.com>
Content-Type: text/plain; charset=US-ASCII; format=flowed
Message-Id: <010728b9543c644eed3e51d2e6da2dbc@outerthought.org>
Content-Transfer-Encoding: 7bit
From: Steven Noels <stevenn@outerthought.org>
Subject: Re: [Docs] A structure for "Getting Started"
Date: Thu, 9 Jun 2005 16:53:35 +0200
To: dev@cocoon.apache.org
X-Mailer: Apple Mail (2.622)
X-Virus-Checked: Checked
X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N

On 09 Jun 2005, at 15:26, Mark Leicester wrote:

> I don't really want to define a global structure a priori because I 
> expect each documentation writer will have their own view of how 
> documentation should be organised.

And we now have a system which accommodates this. I was planning to 
write an email today about how to best tackle document organization and 
classification with our new documentation system, but plans changed 
when the youngest women in my life decided against them.

As you might or might not know, you can have as many sites alongside 
each other if you want, each of them exposing a different hierarchy but 
using the same content.

A "site" is simply a combination of a navtree (of which there can be 
many, and you can even include them into each other) and a default 
collection which is used to restrict searches and to indicate in which 
collection new documents are stored: 
http://cocoondev.org/daisydocs-1_3/daisywiki/general/23.html

So I'd advise not to focus on structure upfront (as you indicate 
yourself already), but on Document Types, more specifically: metadata - 
http://cocoondev.org/daisydocs-1_3/repository/general/17.html is quite 
relevant in this respect.

I'll come back to this when the mother of that young women gets home 
and I can finally get to work. ;)

</Steven>
-- 
Steven Noels                            http://outerthought.org/
Outerthought - Open Source Java & XML            An Orixo Member
Read my weblog at            http://blogs.cocoondev.org/stevenn/
stevenn at outerthought.org                stevenn at apache.org