From: Tom Lane <tgl@sss.pgh.pa.us>
To: Albert Cervera i Areny <albert@nan-tic.com>
Cc: Peter Eisentraut <peter_e@gmx.net>
Cc: pgsql-docs@postgresql.org
Subject: Re: Tips needed for contrib doc
Date: Sun, 14 Oct 2007 15:05:46 -0400
Message-ID: <3002.1192388746@sss.pgh.pa.us> (raw)
In-Reply-To: <200710142017.53672.albert@nan-tic.com>
References: <200710102315.50067.albert@nan-tic.com>
<200710122004.44884.albert@nan-tic.com>
<200710141505.14690.peter_e@gmx.net>
<200710142017.53672.albert@nan-tic.com>
Albert Cervera i Areny <albert@nan-tic.com> writes:
> The problem is that if we want these docs in the Reference section of the
> documentation right after "PostgreSQL Server Applications" they can't be
> chapters nor sections, they need to be <refentry>'s. That's the problem...
In any case one would think that each contrib module should be at the
same logical level in the docs --- if some of them are only sections,
what chapter are they inside of?
One point here is that a lot of the contrib material is not really
written in reference style anyway. I wonder if the best solution is
to make it a separate <part>, with each contrib module being a
<chapter>, and then sections and subsections if needed.
regards, tom lane
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: tgl@sss.pgh.pa.us, albert@nan-tic.com, peter_e@gmx.net
Subject: Re: Tips needed for contrib doc
In-Reply-To: <3002.1192388746@sss.pgh.pa.us>
* 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