Subject: Re: [PATCHES] SQL conformance related patch
From: Simon Riggs <simon@2ndquadrant.com>
To: Troels Arvin <troels@arvin.dk>
Cc: pgsql-patches@postgresql.org, pgsql-docs@postgresql.org
In-Reply-To: <1101381875.3068.27.camel@localhost>
References: <1101381875.3068.27.camel@localhost>
Content-Type: text/plain
Organization: 2nd Quadrant
Message-Id: <1101498748.2870.78.camel@localhost.localdomain>
Mime-Version: 1.0
Date: Fri, 26 Nov 2004 19:52:28 +0000
Content-Transfer-Encoding: 7bit

On Thu, 2004-11-25 at 11:24, Troels Arvin wrote:
> Simon also has ideas for improvement of the conformance documentation
> page (features.sgml), but that's probably a version 8.1 thing. I think
> he'd better describe the ideas himself.

...since you mention it, I should explain:

The sections Supported Features and Unsupported Features cover both
Mandatory (Core) and Optional features in the same section. It would be
better to separate these, just as the SQL standard itself does in Annex
F - SQL Feature Taxonomy.

This seems especially important for the Unsupported Features section,
since the length of the list makes it look like 100% support is a long
way off, whereas it is only 14 features away, and many of them minor
[see Troels' low hanging fruit list on this thread]

Many of the optional features are definitely desirable and it is useful
information to retain the Unsupported optional features, but would be
best as a separate sub-section.

Troels tells me the sections are autogenerated, which makes the
re-editing slightly more difficult, so worth consultation first. 

Not sure who knows how to do that...or what techniques are considered
portable...XSLT?? other than maintaining two separate lists.

-- 
Best Regards, Simon Riggs