pg.ddx.io  pgsql-admin@postgresql.org mailing list archive  
help / color / mirror / Atom feed
From: Guillaume Lelarge <guillaume@lelarge.info>
To: Tom Lane <tgl@sss.pgh.pa.us>
Cc: Jonah H. Harris <jonah.harris@gmail.com>
Cc: Decibel! <decibel@decibel.org>
Cc: Joshua D. Drake <jd@commandprompt.com>
Cc: Dimitri Fontaine <dfontaine@hi-media.com>
Cc: pgsql-admin@postgresql.org, Alvaro Herrera <alvherre@commandprompt.com>
Cc: Chris Hoover <revoohc@gmail.com>
Cc: Bruce Momjian <bruce@momjian.us>
Subject: Re: Where to find information on the new HOT tables?
Date: Wed, 06 Feb 2008 10:27:44 +0100
Message-ID: <47A97D90.1010607@lelarge.info> (raw)
In-Reply-To: <2827.1202278590@sss.pgh.pa.us>
References: <1d219a6f0802051142k882827cyd38ea7a3d7c1e4ea@mail.gmail.com>
	<200802052213.41185.dfontaine@hi-media.com>
	<28211.1202247311@sss.pgh.pa.us>
	<200802052314.02679.dfontaine@hi-media.com>
	<20080205142535.12e5c28e@jd-laptop>
	<29236.1202252251@sss.pgh.pa.us>
	<20080206015351.GM1212@decibel.org>
	<1250.1202267491@sss.pgh.pa.us>
	<20080206045406.GP1212@decibel.org>
	<36e682920802052145lc3b566cr1facc1cd76847a5a@mail.gmail.com>
	<2827.1202278590@sss.pgh.pa.us>

Tom Lane wrote:
> "Jonah H. Harris" <jonah.harris@gmail.com> writes:
>> On Feb 5, 2008 11:54 PM, Decibel! <decibel@decibel.org> wrote:
>>> One of the things that drew me to Postgres years ago was that I could
>>> actually read about how it works in a clear, concise manner.
> 
>> Agreed.
> 
> Not sure how you could argue "concise" as a benefit here.
> 
> There are literally thousands of aspects of the PG codebase that could
> impact performance in user-visible ways.  Most of them are not
> documented in the SGML docs.  If we tried to expose all that, the docs
> would become completely unreadable.  (I just got done reading some
> slashdot griping about how our docs are already too long and too
> complicated for novices, so I'm not feeling particularly charitable
> about proposals to dump even more seldom-useful details into them.)
> 

That's something we hear on booths too. Someone, at Solutions Linux 
2008, told me the manual is great but not that easy to begin with. He 
reads Sébastien Lardière's french book on PostgreSQL and finds it more 
convenient for him. And now he needs something more advanced but still 
not the manual... problem is, he's not able to explain why he doesn't 
like our current manual.

> I'm really not seeing the case for user-level documentation of HOT,
> when for instance most of the planner's optimization behavior is not
> so documented.
> 

A user level, no. But an advanced/developper level documentation would 
be greatly appreciated.

Really, I found our manual great. I've read it many times, I've 
translated it, I think I know it a bit. But I think a 1500 pages manual 
is a bit too much for a beginner. It kind of afraids them. And it may 
not be enough for advanced users. Drawing the line between not enough 
and too much is not that easy. But I'm sure there's work to do on the 
documentation front.

Regards.


-- 
Guillaume.
  http://www.postgresqlfr.org
  http://dalibo.com



view thread (34+ messages)  latest in thread

Message-ID: <47A97D90.1010607@lelarge.info>
Permalink:  ../47A97D90.1010607@lelarge.info/
Also on:    postgresql.org/message-id/47A97D90.1010607@lelarge.info

 · 

reply

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-admin@postgresql.org
  Cc: guillaume@lelarge.info, tgl@sss.pgh.pa.us, jonah.harris@gmail.com, decibel@decibel.org, jd@commandprompt.com, dfontaine@hi-media.com, alvherre@commandprompt.com, revoohc@gmail.com, bruce@momjian.us
  Subject: Re: Where to find information on the new HOT tables?
  In-Reply-To: <47A97D90.1010607@lelarge.info>

* 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