Re: [PATCHES] SQL conformance related patch - Mailing list pgsql-docs

From Simon Riggs
Subject Re: [PATCHES] SQL conformance related patch
Date
Msg-id 1101498748.2870.78.camel@localhost.localdomain
Whole thread Raw
Responses Re: [PATCHES] SQL conformance related patch  (Peter Eisentraut <peter_e@gmx.net>)
List pgsql-docs
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


pgsql-docs by date:

Previous
From: ISHIKAWA Toshiyuki
Date:
Subject: 合宿とかのスケジュール
Next
From: Peter Eisentraut
Date:
Subject: Re: [PATCHES] SQL conformance related patch