Date: Fri, 14 Feb 2020 13:50:29 -0300
From: Alvaro Herrera <alvherre@2ndquadrant.com>
To: Dave Cramer <davecramer@postgres.rocks>
Cc: Tom Lane <tgl@sss.pgh.pa.us>, pgsql-docs@lists.postgresql.org
Subject: Re: documenting divergence from the SQL spec
Message-ID: <20200214165029.GA8387@alvherre.pgsql>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: 
 <CADK3HH+uCN4QpSbGyk1cKh0GgpSpXrWtLHB5UbWntAGZKx1nDA@mail.gmail.com>
User-Agent: Mutt/1.10.1 (2018-07-13)
Precedence: bulk

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