 | | From: | Tom Lane | | Subject: | Whither "External Projects"? | | Date: | Tue, 28 Dec 2004 17:21:27 -0500 |
|
|
 | I'm pretty well convinced that the new docs chapter "External Projects"
does not belong under the Client Interfaces volume. If it only covered
client interfaces then maybe it'd belong there, but it doesn't --- and
I'm sure that the discussion of non-interface projects will expand.
Another possibility is to put it in the Administrator's Guide, but that
seems to suffer from the opposite problem.
We could make it an Appendix, but that sort of amounts to burying the
info, which isn't what we want either.
I'm about half tempted to add it to the Preface.
Thoughts?
regards, tom lane
---------------------------(end of broadcast)---------------------------
TIP 4: Don't 'kill -9' the postmaster
|
|
| | From: | Joshua D. Drake | | Subject: | Re: Whither "External Projects"? | | Date: | Tue, 28 Dec 2004 14:35:21 -0800 |
|
|
| This is a multi-part message in MIME format.
--------------030804020501030204030405
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 7bit
Tom Lane wrote:
>I'm pretty well convinced that the new docs chapter "External Projects"
>does not belong under the Client Interfaces volume. If it only covered
>client interfaces then maybe it'd belong there, but it doesn't --- and
>I'm sure that the discussion of non-interface projects will expand.
>
>Another possibility is to put it in the Administrator's Guide, but that
>seems to suffer from the opposite problem.
>
>We could make it an Appendix, but that sort of amounts to burying the
>info, which isn't what we want either.
>
>I'm about half tempted to add it to the Preface.
>
>
It seems that it should be broken up by the type of external project.
Most I would gather belong in the developers guide but things like
pgAdminIII are probably best suited for the administrators guide.
j
>Thoughts?
>
> regards, tom lane
>
>---------------------------(end of broadcast)---------------------------
>TIP 4: Don't 'kill -9' the postmaster
>
>
--
Command Prompt, Inc., home of Mammoth PostgreSQL - S/ODBC and S/JDBC
Postgresql support, programming shared hosting and dedicated hosting.
+1-503-667-4564 - jd@commandprompt.com - http://www.commandprompt.com
PostgreSQL Replicator -- production quality replication for PostgreSQL
--------------030804020501030204030405
Content-Type: text/x-vcard; charset=utf-8;
name="jd.vcf"
Content-Transfer-Encoding: 7bit
Content-Disposition: attachment;
filename="jd.vcf"
begin:vcard
fn:Joshua Drake
n:Drake;Joshua
org:Command Prompt, Inc.
adr:;;PO Box 215 ;Cascade Locks;OR;97014;US
email;internet:jd@commandprompt.com
title:Consultant
tel;work:503-667-4564
tel;fax:503-210-0334
x-mozilla-html:FALSE
url:http://www.commandprompt.com
version:2.1
end:vcard
--------------030804020501030204030405
Content-Type: text/plain
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
MIME-Version: 1.0
---------------------------(end of broadcast)---------------------------
TIP 8: explain analyze is your friend
--------------030804020501030204030405--
|
|
| | From: | Tom Lane | | Subject: | Re: Whither "External Projects"? | | Date: | Tue, 28 Dec 2004 17:41:05 -0500 |
|
|
| "Joshua D. Drake" writes:
> Tom Lane wrote:
>> I'm pretty well convinced that the new docs chapter "External Projects"
>> does not belong under the Client Interfaces volume.
> It seems that it should be broken up by the type of external project.
> Most I would gather belong in the developers guide but things like
> pgAdminIII are probably best suited for the administrators guide.
Well, the actual meat of the section is the pointer to GBorg and
pgFoundry --- once you've said that the rest of it is more or less
fluff, and quickly-obsoleted fluff at that. I'm not that eager to
duplicate the pointer in different places.
regards, tom lane
---------------------------(end of broadcast)---------------------------
TIP 5: Have you checked our extensive FAQ?
http://www.postgresql.org/docs/faqs/FAQ.html
|
|
| | From: | Bruce Momjian | | Subject: | Re: Whither "External Projects"? | | Date: | Tue, 28 Dec 2004 18:00:09 -0500 (EST) |
|
|
| Tom Lane wrote:
> I'm pretty well convinced that the new docs chapter "External Projects"
> does not belong under the Client Interfaces volume. If it only covered
> client interfaces then maybe it'd belong there, but it doesn't --- and
> I'm sure that the discussion of non-interface projects will expand.
>
> Another possibility is to put it in the Administrator's Guide, but that
> seems to suffer from the opposite problem.
>
> We could make it an Appendix, but that sort of amounts to burying the
> info, which isn't what we want either.
>
> I'm about half tempted to add it to the Preface.
The Preface would be OK if it didn't have so much client-interface
specific stuff in it. I wonder if Appendix is best, with a pointer to
the appendix at the end of the Client section.
--
Bruce Momjian | http://candle.pha.pa.us
pgman@candle.pha.pa.us | (610) 359-1001
+ If your life is a hard drive, | 13 Roberts Road
+ Christ can be your backup. | Newtown Square, Pennsylvania 19073
---------------------------(end of broadcast)---------------------------
TIP 3: if posting/reading through Usenet, please send an appropriate
subscribe-nomail command to majordomo@postgresql.org so that your
message can get through to the mailing list cleanly
|
|
| | From: | Tom Lane | | Subject: | Re: Whither "External Projects"? | | Date: | Tue, 28 Dec 2004 18:18:02 -0500 |
|
|
| Bruce Momjian writes:
> Tom Lane wrote:
>> I'm about half tempted to add it to the Preface.
> The Preface would be OK if it didn't have so much client-interface
> specific stuff in it. I wonder if Appendix is best, with a pointer to
> the appendix at the end of the Client section.
We could do that and put the pointer into the Client front-matter.
regards, tom lane
---------------------------(end of broadcast)---------------------------
TIP 5: Have you checked our extensive FAQ?
http://www.postgresql.org/docs/faqs/FAQ.html
|
|
| | From: | Peter Eisentraut | | Subject: | Re: Whither "External Projects"? | | Date: | Wed, 29 Dec 2004 03:01:36 +0100 |
|
|
| Tom Lane wrote:
> > The Preface would be OK if it didn't have so much client-interface
> > specific stuff in it. I wonder if Appendix is best, with a pointer
> > to the appendix at the end of the Client section.
>
> We could do that and put the pointer into the Client front-matter.
I think that is the best solution. Books are usually organized like
that.
---------------------------(end of broadcast)---------------------------
TIP 8: explain analyze is your friend
|
|
