Date: Mon, 15 Aug 2005 19:26:51 -0500
From: "Jim C. Nasby" <jnasby@pervasive.com>
To: Andrew Ford <A.Ford@ford-mason.co.uk>
Cc: "Joshua D. Drake" <jd@commandprompt.com>,
	pgsql-docs@postgresql.org, swm@linuxworld.com.au
Subject: Re: Article doing a basic comparison of MySQL, Oracle, PostgreSQL
Message-ID: <20050816002651.GQ78011@pervasive.com>
References: <Pine.LNX.4.58.0508111644100.781@linuxworld.com.au>
	<42FB69E3.10300@commandprompt.com>
	<42FB8202.4000607@ford-mason.co.uk>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <42FB8202.4000607@ford-mason.co.uk>
User-Agent: Mutt/1.5.9i

On Thu, Aug 11, 2005 at 05:51:14PM +0100, Andrew Ford wrote:
> Joshua D. Drake wrote:
> 
> >
> >>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.
> 
> I think that the documentation should be split (back out) into separate 
> books -- tutorial, reference, release notes, etc.  It is too unwieldy as 
> it is.  The release notes at least should be separate -- I was rather 

I always have trouble finding info, just about anywhere on the site, and
the docs are no exception. I generally just use the SQL reference, but
there's still a lot of info that's not in that reference.

In this case, I think the real issue is a matter of website design. It
would be good if there was a prominent 'Getting started' link somewhere.
-- 
Jim C. Nasby, Sr. Engineering Consultant      jnasby@pervasive.com
Pervasive Software        http://pervasive.com        512-569-9461