User's Guide Reorganization Plan - Mailing list pgsql-docs

From Peter Eisentraut
Subject User's Guide Reorganization Plan
Date
Msg-id Pine.LNX.4.44.0207302324270.2824-100000@localhost.localdomain
Whole thread Raw
List pgsql-docs
I'm reorganizing the User's Guide (slightly) to "make room" for
descriptions of new features such as schemas, new privileges, dependency
tracking, and also to allow the book to be read approximately
sequentially.

Here's the new Table of Contents:

1. Syntax [no change]
2. Data Definition

Covers table creation, constraints, schemas, privileges, touches on views.
I've started to write this.

3. Data Manipulation

Insert, Update, Delete, a bit about rules and triggers.  Not written yet.

4. Queries [no change]
5. Data Types [no change]
6. Functions and Operators [no change]
7. Type Conversion

Add information about new cast system here.  I don't think this should
really be a chapter of its own, but it's unclear where else it would
belong.

[Move Arrays chapter into 5. Data Types]

8. Indexes [no change]

[Move Inheritance chapter into 2. Data Definition]

9. Concurrency Control
10. Performance Tips

A snippet about databases will be put into 2. Data Definition, where it
fits together with schemas.  The rest will be deferred to the Admin Guide.

Comments?

--
Peter Eisentraut   peter_e@gmx.net


pgsql-docs by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: Doc
Next
From: Rich Morin
Date:
Subject: Any DocBook wizards on the list?