Re: documenting divergence from the SQL spec

From: Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>
To: Dave Cramer <davecramer(at)postgres(dot)rocks>
Cc: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: documenting divergence from the SQL spec
Date: 2020-02-14 16:50:29
Message-ID: 20200214165029.GA8387@alvherre.pgsql
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On 2020-Feb-14, Dave Cramer wrote:

> The wiki seems to be the dumping ground for everything that doesn't fit
> into the documentation.
> The problem with this is that if you don't know it is documented there it
> is very difficult to find.

Would it help to have some sort of index? The simplest I can think of
is to add <indexterm> for each Nonstandard Clauses section, with
something like

<primary>Nonstandard Clauses</primary>
<secondary>in SELECT</secondary>

so that in the index you'd get a list of all commands that have
Nonstandard Clauses subsections.

Perhaps something more sophisticated can be built by using dedicated XML
tags in an ad-hoc namespace.

--
Álvaro Herrera https://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Jürgen Purtz 2020-02-14 17:42:02 Re: Shrinking SVG (Again)
Previous Message Dave Cramer 2020-02-14 16:43:00 Re: documenting divergence from the SQL spec