[DOCS] Whither "External Projects"?
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
Re: [DOCS] Whither "External Projects"?
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 - [EMAIL PROTECTED] - http://www.commandprompt.com PostgreSQL Replicator -- production quality replication for PostgreSQL begin:vcard fn:Joshua Drake n:Drake;Joshua org:Command Prompt, Inc. adr:;;PO Box 215 ;Cascade Locks;OR;97014;US email;internet:[EMAIL PROTECTED] 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 ---(end of broadcast)--- TIP 8: explain analyze is your friend
Re: [DOCS] Whither "External Projects"?
"Joshua D. Drake" <[EMAIL PROTECTED]> 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
Re: [DOCS] Whither "External Projects"?
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 [email protected] | (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 [EMAIL PROTECTED] so that your message can get through to the mailing list cleanly
Re: [DOCS] Whither "External Projects"?
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
Re: [DOCS] Whither "External Projects"?
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
