Received: from localhost (maia-4.hub.org [200.46.204.183]) by postgresql.org (Postfix) with ESMTP id 8F02C9FA0FB for ; Sat, 9 Dec 2006 22:54:49 -0400 (AST) Received: from postgresql.org ([200.46.204.71]) by localhost (mx1.hub.org [200.46.204.183]) (amavisd-new, port 10024) with ESMTP id 75628-03 for ; Sat, 9 Dec 2006 22:54:48 -0400 (AST) X-Greylist: from auto-whitelisted by SQLgrey-1.7.4 Received: from smtp5.clear.net.nz (smtp5.clear.net.nz [203.97.33.68]) by postgresql.org (Postfix) with ESMTP id 07DA29FA0EF for ; Sat, 9 Dec 2006 22:54:48 -0400 (AST) Received: from [192.168.1.11] (121-72-71-26.dsl.telstraclear.net [121.72.71.26]) by smtp5.clear.net.nz (CLEAR Net Mail) with ESMTP id <0JA10019OER9HB40@smtp5.clear.net.nz> for pgsql-docs@postgresql.org; Sun, 10 Dec 2006 15:54:46 +1300 (NZDT) Date: Sun, 10 Dec 2006 15:54:35 +1300 From: Mark Kirkwood Subject: Re: Switching to XML In-reply-to: <19134.1165688326@sss.pgh.pa.us> To: Tom Lane Cc: Josh Berkus , Peter Eisentraut , pgsql-docs@postgresql.org, David Blewett Message-id: <457B76EB.4010701@paradise.net.nz> MIME-version: 1.0 Content-type: text/plain; charset=ISO-8859-1; format=flowed Content-transfer-encoding: 7bit References: <4579720E.4000707@dawninglight.net> <200612081902.11483.peter_e@gmx.net> <4579B0B3.10507@agliodbs.com> <19134.1165688326@sss.pgh.pa.us> User-Agent: Thunderbird 1.5.0.8 (X11/20061129) X-Archive-Number: 200612/64 X-Sequence-Number: 3987 Tom Lane wrote: > > As for authoring tools, show me one that produces SGML or XML that's > reasonably readable, and I might worry about allowing people to use it. > Most of the ones I've seen would render the doc sources unreadable for > anyone not using an authoring tool (possibly even the very same > authoring tool). We are not going to move in that direction > because it would piss off the people who do the bulk of the work now. > +1 With regards to the current setup discouraging contribution - I've done one (or maybe two) doc submissions and ISTR that it was not very difficult - even as a complete SGML newbie - to get up and running, make my changes and build the (HTML) docs. Cheers Mark