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 4E084862F for ; Sun, 28 Aug 2011 13:40:59 +0000 (UTC) Received: (qmail 54820 invoked by uid 500); 28 Aug 2011 13:40:59 -0000 Delivered-To: apmail-cayenne-dev-archive@cayenne.apache.org Received: (qmail 54704 invoked by uid 500); 28 Aug 2011 13:40:57 -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 54696 invoked by uid 99); 28 Aug 2011 13:40:57 -0000 Received: from athena.apache.org (HELO athena.apache.org) (140.211.11.136) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 28 Aug 2011 13:40:57 +0000 X-ASF-Spam-Status: No, hits=-0.0 required=5.0 tests=SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (athena.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; Sun, 28 Aug 2011 13:40:50 +0000 Received: (qmail 23958 invoked from network); 28 Aug 2011 13:40:29 -0000 Received: from unknown (HELO ?127.0.0.1?) (127.0.0.1) by localhost with SMTP; 28 Aug 2011 13:40:29 -0000 Content-Type: text/plain; charset=us-ascii Mime-Version: 1.0 (Apple Message framework v1084) Subject: Re: docbook - continued From: Andrus Adamchik In-Reply-To: Date: Sun, 28 Aug 2011 15:40:28 +0200 Content-Transfer-Encoding: quoted-printable Message-Id: <08B40CE3-A206-4C93-B4F8-C61DF0815522@objectstyle.org> References: <95584249-7F68-4248-A6CD-C6853F90A80C@objectstyle.org> <4E591646.7000307@maniatis.org> To: dev@cayenne.apache.org X-Mailer: Apple Mail (2.1084) On Aug 28, 2011, at 12:30 PM, Andrus Adamchik wrote: > I am less concerned about syntax coloring though, more about code = blocks standing out on the page via a different background color and/or = border. Especially since the PDF version is likely be black and white = (?) Same thing for the tables. I just started on Appendix A (a list of = Cayenne properties) and the big font used for the blocks and the = lack of borders and backgrounds make them a bit unreadable in either = HTML or PDF formats. Also even though we only have like 5% of the new docs ready, I think = this maybe the 5% that matters. I almost finished all the DI and = ServerRuntime chapters. So we should consider publishing this on the = site and with the upcoming release. BTW, working on the docs now allows me to take a user view of the = framework, and I am noticing things that we can polish a bit. Two most = obvious points: 1. DI property names per Appendix A (make them shorter and more = symmetrical) 2. Default modeler object naming (UntitledDomain, UntiltledDomainMap) = trickles to the XML file naming, so we'd rather come up with something = that makes sense. E.g. "project" for domains (there can be only 1 per = project in 3.1), "datamap", "datamap1", etc. for DataMaps. These will = result in cleaner file names like cayenne-project.xml, datamap.map.xml = etc.). Andrus=