X-Original-To: pgsql-docs-postgresql.org@localhost.postgresql.org
Received: from localhost (unknown [200.46.204.144])
	by svr1.postgresql.org (Postfix) with ESMTP id D636A52FFF
	for <pgsql-docs-postgresql.org@localhost.postgresql.org>;
	Thu, 11 Aug 2005 12:08:37 -0300 (ADT)
Received: from svr1.postgresql.org ([200.46.204.71])
	by localhost (av.hub.org [200.46.204.144]) (amavisd-new, port 10024)
	with ESMTP id 37060-09
	for <pgsql-docs-postgresql.org@localhost.postgresql.org>;
	Thu, 11 Aug 2005 15:08:34 +0000 (GMT)
Received: from hosting.commandprompt.com (128.commandprompt.com
	[207.173.200.128])
	by svr1.postgresql.org (Postfix) with ESMTP id DBEC352FDE
	for <pgsql-docs@postgresql.org>; Thu, 11 Aug 2005 12:08:33 -0300 (ADT)
Received: from [192.168.1.100] (clbb-248.saw.net [64.146.135.248])
	(authenticated bits=0)
	by hosting.commandprompt.com (8.13.4/8.13.4) with ESMTP id
	j7BF7AwH005409; Thu, 11 Aug 2005 08:07:14 -0700
Message-ID: <42FB69E3.10300@commandprompt.com>
Date: Thu, 11 Aug 2005 08:08:19 -0700
From: "Joshua D. Drake" <jd@commandprompt.com>
User-Agent: Mozilla Thunderbird 1.0.6 (X11/20050727)
X-Accept-Language: en-us, en
MIME-Version: 1.0
To: Gavin Sherry <swm@linuxworld.com.au>
Cc: pgsql-docs@postgresql.org
Subject: Re: Article doing a basic comparison of MySQL, Oracle, PostgreSQL
References: <Pine.LNX.4.58.0508111644100.781@linuxworld.com.au>
In-Reply-To: <Pine.LNX.4.58.0508111644100.781@linuxworld.com.au>
Content-Type: text/plain; charset=US-ASCII; format=flowed
Content-Transfer-Encoding: 7bit
X-Greylist: Sender succeded SMTP AUTH authentication, not delayed by
	milter-greylist-1.6 (hosting.commandprompt.com [192.168.1.101]);
	Thu, 11 Aug 2005 08:07:14 -0700 (PDT)
X-Virus-Scanned: by amavisd-new at hub.org
X-Spam-Status: No, hits=0.024 tagged_above=0 required=5 tests=[AWL=0.024]
X-Spam-Level: 
X-Archive-Number: 200508/10
X-Sequence-Number: 3172


>I find this peculiar, considering this:
>
>http://www.postgresql.org/docs/8.0/static/tutorial-start.html
>
>Now, perhaps the author's conclusion is just bogus but can anyone think of
>better ways in which we could ease people into PostgreSQL?
>  
>
I think more than likely it just isn't obvious where the tutorial is.
I just went to the website, I clicked documentation, no immediate
mention of the tutorial. Then I click 8.0, where is the tutorial?

Oh... it is in the beginning of the 1300 pages of documentation.

Honestly, I didn't even know it was there. Of course I haven't had
need for it, but if I couldn't readily find it in 1 click (which is what
it should be) then a guy writing an article isn't going to either.

The tutorial/introduction should be a nice fat link in the center of
the page when you click documentation.

Right now when you click documentation you get this:

There is a wealth of PostgreSQL information available online. This 
section contains current <http://www.postgresql.org/docs/manuals> and 
archived <http://www.postgresql.org/docs/manuals/archive> manuals for 
PostgreSQL users, as well as frequently asked questions 
<http://www.postgresql.org/docs/faq>.

You can learn what's new <http://www.postgresql.org/docs/whatsnew> in 
the latest release, and view a listing of books 
<http://www.postgresql.org/docs/books> written about PostgreSQL (some of 
which are available in their entirety online). Technical documentation 
<http://techdocs.postgresql.org> is also available in this section.

Which should probably be:

There is a wealth of PostgreSQL information available online. If you are 
new to PostgreSQL we strongly suggest you check out
the latest <BOLD>Tutorial</BOLD>. This section contains current 
<http://www.postgresql.org/docs/manuals> and archived 
<http://www.postgresql.org/docs/manuals/archive> manuals for PostgreSQL 
users, as well as frequently asked questions 
<http://www.postgresql.org/docs/faq>.

You can learn what's new <http://www.postgresql.org/docs/whatsnew> in 
the latest release, and view a listing of books 
<http://www.postgresql.org/docs/books> written about PostgreSQL (some of 
which are available in their entirety online). Technical documentation 
<http://techdocs.postgresql.org> is also available in this section.



Sincerely,

Joshua D. Drake



>Thanks,
>
>Gavin
>
>---------------------------(end of broadcast)---------------------------
>TIP 9: In versions below 8.0, the planner will ignore your desire to
>       choose an index scan if your joining column's datatypes do not
>       match
>  
>