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