public inbox for [email protected]help / color / mirror / Atom feed
Platform FAQs 5+ messages / 3 participants [nested] [flat]
* Platform FAQs @ 2002-09-29 12:13 Peter Eisentraut <[email protected]> 0 siblings, 2 replies; 5+ messages in thread From: Peter Eisentraut @ 2002-09-29 12:13 UTC (permalink / raw) To: pgsql-docs I would like to integrate the platform FAQs into the installation instructions, into a new section "Platform-specific Notes". That way it would be more convenient both to find and to maintain that information. Comments? -- Peter Eisentraut [email protected] ^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: Platform FAQs @ 2002-09-29 13:42 Bruce Momjian <[email protected]> parent: Peter Eisentraut <[email protected]> 1 sibling, 0 replies; 5+ messages in thread From: Bruce Momjian @ 2002-09-29 13:42 UTC (permalink / raw) To: Peter Eisentraut <[email protected]>; +Cc: pgsql-docs Peter Eisentraut wrote: > I would like to integrate the platform FAQs into the installation > instructions, into a new section "Platform-specific Notes". That way it > would be more convenient both to find and to maintain that information. > Comments? Sure. They are changed very rarely. The only issue is the main FAQ, which does get translated into different languages. -- 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 ^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: Platform FAQs @ 2002-09-29 15:20 Tom Lane <[email protected]> parent: Peter Eisentraut <[email protected]> 1 sibling, 1 reply; 5+ messages in thread From: Tom Lane @ 2002-09-29 15:20 UTC (permalink / raw) To: Peter Eisentraut <[email protected]>; +Cc: pgsql-docs Peter Eisentraut <[email protected]> writes: > I would like to integrate the platform FAQs into the installation > instructions, into a new section "Platform-specific Notes". That way it > would be more convenient both to find and to maintain that information. > Comments? IIRC, some of the platform FAQs contain some material that doesn't really fit under installation instructions; will you also be adding platform-specific notes in the regression test discussion and perhaps other places? I like the platform FAQ arrangement because it's simple to whip out a new platform FAQ based on notes from a port developer. It's also easy for someone using a platform to find all the platform-specific material they need to know. I'm not sure that moving the info into the already-massive SGML docs would really be a step forward. regards, tom lane ^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: Platform FAQs @ 2002-09-30 21:40 Peter Eisentraut <[email protected]> parent: Tom Lane <[email protected]> 0 siblings, 1 reply; 5+ messages in thread From: Peter Eisentraut @ 2002-09-30 21:40 UTC (permalink / raw) To: Tom Lane <[email protected]>; +Cc: pgsql-docs Tom Lane writes: > IIRC, some of the platform FAQs contain some material that doesn't > really fit under installation instructions; will you also be adding > platform-specific notes in the regression test discussion and perhaps > other places? To the extent that they do not simply say "there may be differences" when we know very well that there aren't and shouldn't be any differences, yes. The only legitimate issue I know of is the ordering problem on IRIX. > I like the platform FAQ arrangement because it's simple to whip out > a new platform FAQ based on notes from a port developer. Yes, it's simple to whip out a new document and then forget about it. Most of the information is simply redundant, vague, or no longer documents the preferred methods, and these files encourage documenting problems rather than fixing them. > It's also easy for someone using a platform to find all the > platform-specific material they need to know. I'm not sure that moving > the info into the already-massive SGML docs would really be a step > forward. We left that route some time ago. Documentation about configuring kernel resources is now in the Admin Guide, and it's at least as easy to find it there if you're thinking of "configuring" your server instead of "hmm, I'm configuring, so maybe that is a platform-specific issue". By the same token, if I'm thinking of installing I would read the installation instructions and I might expect to find relevant information there, independent of whether it's platform-dependent, which the user wouldn't know anyway. I'll start with merging the redundant information and then see how it goes. -- Peter Eisentraut [email protected] ^ permalink raw reply [nested|flat] 5+ messages in thread
* Re: Platform FAQs @ 2002-09-30 22:18 Tom Lane <[email protected]> parent: Peter Eisentraut <[email protected]> 0 siblings, 0 replies; 5+ messages in thread From: Tom Lane @ 2002-09-30 22:18 UTC (permalink / raw) To: Peter Eisentraut <[email protected]>; +Cc: pgsql-docs Peter Eisentraut <[email protected]> writes: > Tom Lane writes: >> I like the platform FAQ arrangement because it's simple to whip out >> a new platform FAQ based on notes from a port developer. > Yes, it's simple to whip out a new document and then forget about it. True :-(. Well, give it a shot and see how you like the results ... regards, tom lane ^ permalink raw reply [nested|flat] 5+ messages in thread
end of thread, other threads:[~2002-09-30 22:18 UTC | newest] Thread overview: 5+ messages (download: mbox mbox.gz follow: Atom feed) -- links below jump to the message on this page -- 2002-09-29 12:13 Platform FAQs Peter Eisentraut <[email protected]> 2002-09-29 13:42 ` Bruce Momjian <[email protected]> 2002-09-29 15:20 ` Tom Lane <[email protected]> 2002-09-30 21:40 ` Peter Eisentraut <[email protected]> 2002-09-30 22:18 ` Tom Lane <[email protected]>
This inbox is served by agora; see mirroring instructions for how to clone and mirror all data and code used for this inbox