From: Robert Treat <xzilla@users.sourceforge.net>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Jim C. Nasby <jnasby@pervasive.com>
Cc: pgsql-docs@postgresql.org, David Fetter <david@fetter.org>
Subject: Re: Get docs for contrib on the web somewhere
Date: Sat, 18 Mar 2006 02:16:35 -0500
Message-ID: <200603180216.35679.xzilla@users.sourceforge.net> (raw)
In-Reply-To: <13875.1142665203@sss.pgh.pa.us>
References: <20060308195047.GI45250@pervasive.com>
<20060318063104.GF15742@pervasive.com>
<13875.1142665203@sss.pgh.pa.us>
On Saturday 18 March 2006 02:00, Tom Lane wrote:
> "Jim C. Nasby" <jnasby@pervasive.com> writes:
> > On Fri, Mar 17, 2006 at 04:19:58PM -0500, Robert Treat wrote:
> >> Could we require contrib authors to provide their documentation as sgml,
> >> and then have the doc build process loop in each contrib module as an
> >> appendix inside the official docs?
> >
> > Can't we just copy the text files over somewhere?
>
> I think the entire point of contrib is that it's "not ready for prime
> time" code, and one of the ways in which it's likely to be not ready
> is not having sgml-format documentation.
>
> If someone wants to step up and do the work to convert the existing
> contrib doc files to sgml, I certainly won't stand in the way --- but
> I'm not prepared to remove contrib entries just because they don't have
> sgml-format docs.
>
Well sure... I'd probably be willing to help out with that, considering that
(in theory) we're going to be removing some of them anyway, so that would cut
down on the work. And this could be a requirement for future contrib items. I
think the real question is would someone be willing to step up and fix the
build process to pull these items into the main docs if they were to be
converted to sgml. I think that's the harder of the two problems to solve.
--
Robert Treat
Build A Brighter Lamp :: Linux Apache {middleware} PostgreSQL
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: xzilla@users.sourceforge.net, tgl@sss.pgh.pa.us, jnasby@pervasive.com, david@fetter.org
Subject: Re: Get docs for contrib on the web somewhere
In-Reply-To: <200603180216.35679.xzilla@users.sourceforge.net>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox