Re: Is my MySQL Gaining ?

Chris Travers <chris@travelamericas.com>

From: "Chris Travers" <chris@travelamericas.com>
To: "Bruno Wolff III" <bruno@wolff.to>, "Tom Lane" <tgl@sss.pgh.pa.us>
Cc: "John Sidney-Woollett" <johnsw@wardbrook.com>, "Ericson Smith" <eric@did-it.com>, "pgsql-general@postgresql . org" <pgsql-general@postgresql.org>
Date: 2003-12-31T02:54:13Z
Lists: pgsql-hackers
Tom Lane <tgl@sss.pgh.pa.us> Wrote:
> BTW, I'd not be in favor of separating out the Tutorial into a separate
> document again, precisely because we would lose the ability for it to
> easily cross-reference the main docs.

I understand your point.  I was just thinking that the other documents are
aimed at experienced users, and that the Tutorial as of now, does not seem
to fill the need for a beginner.  I understand that there is a lot of
resistance here to including other generally useful information such as
database design basics, as it would require more maintenance than simply
putting PostgreSQL-only material in the docs.

However, my question is this-- how much more work (long-term) would it take
to maintain a set of links to resources we have no control over compared to
including information such as this in the Tutorial?  If the material is
truly generic, then once we have a good set of resources then maintenance
will not be a large issue, and cross-linking will be far easier because we
have control over the documentation.  It may be more work at first, but in
the end, I think it will solve more problems than it creates.

I guess the current format is good-- 4 books more or less integrated into
one.   BTW, I took another look at the tutorial, and it is far better than
it was in previous versions.  I still think it needs some expansion (and
would be happy to help).  Or perhaps we should add another document-- The
Beginner's Guide, or would this be better handled by Techdocs?

Best Wishes,
Chris Travers