Re: Is my MySQL Gaining ?

B. van Ouwerkerk <bvo@atz.nl>

From: "B. van Ouwerkerk" <bvo@atz.nl>
To: pgsql-general@postgresql.org
Date: 2003-12-29T21:11:22Z
Lists: pgsql-hackers
SNIP

> > Many of these subjects already *are* covered in the Tutorial.  Just
> > looking in the 7.4 table of contents, I see
> >
> > 3. Advanced Features
> >      3.1. Introduction
> >      3.2. Views
> >      3.3. Foreign Keys
> >      3.4. Transactions
> >      3.5. Inheritance
> >      3.6. Conclusion
> >
> > The discussions are skimpy and could use fleshed out a little, no doubt.
> > (Anyone who wants to contribute material is surely welcome to.)

SNIP

>This concerns me.  This is the second time recently someone has said something
>is NOT documented and it it turn out it is.
>
>So my question is (no offense to anyone) are the web sites not "clear" 
>enough to
>find information quickly or are people just being lax/lazy when they are 
>searching.

No offence.. but..

Not clear enough? Not sure. What I do think is that some pages do not go 
into greater detail where they could and imo should.

I have presented this before as an example. If you install PG you're 
supposed to create a user postgres but nobody writes about what shell that 
user needs and even if that user is supposed to have a shell at all.. 
homedir etc?? dunno..
Another example? alright, data types. I found a very helpful list at the 
website but I didn't see the limitations per type (maximum lenght like 
MySQL says varchar max 255), or is it hidden somewhere on the PG website?.

While working on PG with PHP I noticed several warnings and notices. The PG 
docs did mention all of them but not if they are good or bad so the hunting 
continues via google.
FWIW, if you feed the message to the PG search it doesn't return anything.

It would certainly help if the docs would clarify if something is good or bad.

Some messages ago I saw someone writing about something like "this is the 
manual not handholding". IMO there is a difference between a well written 
and complete manual and handholding.
Having said that, I realise it's a lot of work to keep good documentation 
into synch with development..

If find the search on Postgresql.org slow and not always very logical, but 
I think that has been said before..



B.