Mailing-List: contact dev-help@cocoon.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@cocoon.apache.org
Received-SPF: neutral (hermes.apache.org: local policy)
Message-ID: <42AD3AEB.6020203@apache.org>
Date: Mon, 13 Jun 2005 09:51:07 +0200
From: Reinhard Poetz <reinhard@apache.org>
User-Agent: Mozilla Thunderbird 0.9 (Windows/20041103)
MIME-Version: 1.0
To: dev@cocoon.apache.org
Subject: Re: [VOTE] Consensus about documentation location
References: <329A68716B57D54E8D39FD3F8A4A84DF01AAF6B7@um-mail0136.unimaas.nl>
In-Reply-To: <329A68716B57D54E8D39FD3F8A4A84DF01AAF6B7@um-mail0136.unimaas.nl>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 8bit

Linden H van der (MI) wrote:

Many thanks for the summary and the vote. I have to admit that I wasn't able to 
read all the mails.

> Guys,
> 
> I'm aware that I'm not officially a committer (yet), however, I think it
> will be a good idea to get explicit consensus on where to locate the
> docs and about a rough outline of the future actions.
> 
> This is the proposal:
> 
> - the current Daisy site at the zones [1] will be the "incubator" for
> the new documentation. I.e. new content is to be entered there.
> - this documentation is targeted at Cocoon 2.2. This means that we try
> to write version-independent documentation, but when there is a
> difference between 2.1 and 2.2, the documentation will describe 2.2.
> - the rules for the various roles have been defined already [2]. Note,
> registered guests can leave comments.
> - this also implies that we stick with Daisy as CMS (and not venture on
> the endless hunt for THE best system/toolset).
> - all current content in both wiki and "official docs" will be evaluated
> and either deprecated or moved over into the Daisy site.
> - once the wiki is "processed" (i.e. all documentation is (re)moved), it
> will only serve as a scratchpad, either for random thoughts/proposals or
> for users that want to offer documentation but have no editor rights in
> the Daisy site. I.e. the content of the wiki should be kept as small as
> possible and deprecated information should be removed as soon as
> possible.

+1 for all

> - the current intention is to eventually move the content of the Daisy
> site over to the "official documentation". This is no hard coded rule
> and may be changed later.

Maybe it has already been discussed and then I'm more than happy with a link but 
if not, can you explain the process of how our documentation gets published 
(http://cocoon.apache.org)? IIUC, cocoon.zones.apache.org/daisy/ is our staging 
area and not the official documentation, right?

Another question is the relationship between our generated documentation and the 
CMS? Are there any guidelines where we draw the borderline and the integration 
process to get one documentation in the end?


-- 
Reinhard P�tz           Independent Consultant, Trainer & (IT)-Coach 

{Software Engineering, Open Source, Web Applications, Apache Cocoon}

                                        web(log): http://www.poetz.cc
--------------------------------------------------------------------