Return-Path: Delivered-To: apmail-cocoon-dev-archive@www.apache.org Received: (qmail 2450 invoked from network); 11 Apr 2005 10:02:47 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 11 Apr 2005 10:02:47 -0000 Received: (qmail 30849 invoked by uid 500); 11 Apr 2005 10:02:40 -0000 Delivered-To: apmail-cocoon-dev-archive@cocoon.apache.org Received: (qmail 30759 invoked by uid 500); 11 Apr 2005 10:02:40 -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 30713 invoked by uid 99); 11 Apr 2005 10:02:38 -0000 X-ASF-Spam-Status: No, hits=0.1 required=10.0 tests=FORGED_RCVD_HELO X-Spam-Check-By: apache.org Received-SPF: neutral (hermes.apache.org: local policy) Received: from out1.smtp.messagingengine.com (HELO out1.smtp.messagingengine.com) (66.111.4.25) by apache.org (qpsmtpd/0.28) with ESMTP; Mon, 11 Apr 2005 03:02:37 -0700 Received: from frontend2.messagingengine.com (frontend2.internal [10.202.2.151]) by frontend1.messagingengine.com (Postfix) with ESMTP id A4E3DC71A2E for ; Mon, 11 Apr 2005 06:02:34 -0400 (EDT) X-Sasl-enc: /Kdyh14KFO97qVEX1DuifQ 1113213754 Received: from [10.0.0.3] (elfriedeholmes.demon.co.uk [80.177.165.206]) by www.fastmail.fm (Postfix) with ESMTP id 11566570159 for ; Mon, 11 Apr 2005 06:02:33 -0400 (EDT) Message-ID: <425A4B34.4070903@upaya.co.uk> Date: Mon, 11 Apr 2005 11:02:28 +0100 From: Upayavira User-Agent: Mozilla Thunderbird 0.9 (X11/20041124) X-Accept-Language: en-us, en MIME-Version: 1.0 To: dev@cocoon.apache.org Subject: 2.2 Documentation page naming Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Virus-Checked: Checked X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N I've written a script that will convert old 2.1/2.2 documentation into the proposed new format. However, because we're switching from a hierarchical to a flat naming, we need a mapping between documents. I have committed a document that shows my proposed mapping. Please comment/correct/update. It can be found at: http://svn.apache.org/repos/asf/cocoon/whiteboard/doc-repos/mapping-2.2.txt This document also includes proposals for documentation to be simply removed. Here's some observations: 1) The CTWIG docs aren't actually available on the site right now - probably because there's no link to them, so the pages weren't generated. As I understand it, they are very much 2.0 related, and we need new tutorials of that nature. I therefore propose to remove this from the 2.2 docs. 2) The FAQ section is COMPLETELY EMPTY! So lets remove it. We can always add another should we wish to. At least there isn't any content to move over! 3) The 'developing/dev guide section seems to relate to developing webapps in 2.0. In 2.1/2.2, with CForms, flowscript, it is very different. I propose to keep some of the info here, which is still relevant, move the relevant portal docs into the portal block, and scrap the rest - certainly the section will no longer exist. 4) Some content (e.g. tracks) would be easier to write from scratch, conceiving exactly the docs we need, rather than trying to fit these docs in somehow. I have therefore marked these as REMOVE. Please follow the format I've used (comments in brackets, eg REMOVE), filenames before the bracket, if any, as this is the format my script expects. Regards, Upayavira