Return-Path: X-Original-To: apmail-cayenne-dev-archive@www.apache.org Delivered-To: apmail-cayenne-dev-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 08E4F4C42 for ; Thu, 26 May 2011 00:25:55 +0000 (UTC) Received: (qmail 56950 invoked by uid 500); 26 May 2011 00:25:54 -0000 Delivered-To: apmail-cayenne-dev-archive@cayenne.apache.org Received: (qmail 56931 invoked by uid 500); 26 May 2011 00:25:54 -0000 Mailing-List: contact dev-help@cayenne.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: dev@cayenne.apache.org Delivered-To: mailing list dev@cayenne.apache.org Received: (qmail 56923 invoked by uid 99); 26 May 2011 00:25:54 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Thu, 26 May 2011 00:25:54 +0000 X-ASF-Spam-Status: No, hits=-0.0 required=5.0 tests=SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (nike.apache.org: local policy) Received: from [208.78.103.231] (HELO vorsha.objectstyle.org) (208.78.103.231) by apache.org (qpsmtpd/0.29) with SMTP; Thu, 26 May 2011 00:25:47 +0000 Received: (qmail 18069 invoked from network); 26 May 2011 00:25:26 -0000 Received: from unknown (HELO ?IPv6:::1?) (127.0.0.1) by localhost with SMTP; 26 May 2011 00:25:26 -0000 Content-Type: text/plain; charset=us-ascii Mime-Version: 1.0 (Apple Message framework v1084) Subject: Re: docbook From: Andrus Adamchik In-Reply-To: <4DDD9C12.2050506@maniatis.org> Date: Wed, 25 May 2011 20:25:25 -0400 Content-Transfer-Encoding: quoted-printable Message-Id: References: <20110501140703.3ACF42388A39@eris.apache.org> <4DC7A1A5.9090001@maniatis.org> <1E65CC16-01D8-479A-8993-948ADEC73E91@objectstyle.org> <4DDD9C12.2050506@maniatis.org> To: dev@cayenne.apache.org X-Mailer: Apple Mail (2.1084) X-Virus-Checked: Checked by ClamAV on apache.org On May 25, 2011, at 8:17 PM, Aristedes Maniatis wrote: > The best guide for writing docbook format is the online SageHill site. >=20 > http://www.sagehill.net/docbookxsl/ Checking it out now. >=20 > By far the best tool for writing docbook is Oxygen. We have had an = offer for free licenses for the Cayenne committers, should we go down = the docbook path. Would be nice if we could get it. > I've tried some html to docbook converters, but the effort to clean up = the result was about equal to the effort in just copying the text over = by hand. I am fine with that. Aside from the lack of time factor, I wouldn't mind = going through all docs and reorganizing them to match the modern version = of Cayenne. > The thing with docbook is that there are 10 ways to do anything. We = need to write our own style guide for the choices we make and keep it = consistent. For example, there are about 6 different types of list. So can you take a lead on that? Andrus=