Re: Placement of contrib modules in SGML documentation

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: Bruce Momjian <bruce(at)momjian(dot)us>
Cc: pgsql-docs(at)postgresql(dot)org
Subject: Re: Placement of contrib modules in SGML documentation
Date: 2007-11-14 01:56:46
Message-ID: 11707.1195005406@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Bruce Momjian <bruce(at)momjian(dot)us> writes:
> Tom Lane wrote:
>> I think there's a case for putting these pages under Part V Server
>> Programming (though a few are not in fact server-side code), or under
>> Part VI Reference (ignoring the fact that most of the text isn't in a
>> uniform reference-page style ... though maybe we could plan to work
>> towards that) or under Appendixes (though I'm sure there are people
>> who will complain about that because their private agenda is to make
>> these things as prominent as possible). Or we could make them a new
>> top-level Part, probably just after Reference.

> I think appendix is the right place myself.

An argument in favor of that is that we've got External Projects as
an appendix too, and it seems to make sense to put contrib next door
to them.

I'll go with that for the moment, and 'Additional Supplied Modules'
as the title --- we can always change again later if there's a better
idea.

regards, tom lane

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Tom Lane 2007-11-14 02:02:06 Obsolete references to GBorg in documentation
Previous Message Tom Lane 2007-11-14 00:29:23 Re: Contrib docs v1