From: Alvaro Herrera <alvherre@2ndquadrant.com>
To: Dave Cramer <davecramer@postgres.rocks>
Cc: Tom Lane <tgl@sss.pgh.pa.us>
Cc: pgsql-docs@lists.postgresql.org
Subject: Re: documenting divergence from the SQL spec
Date: Fri, 14 Feb 2020 13:50:29 -0300
Message-ID: <20200214165029.GA8387@alvherre.pgsql> (raw)
In-Reply-To: <CADK3HH+uCN4QpSbGyk1cKh0GgpSpXrWtLHB5UbWntAGZKx1nDA@mail.gmail.com>
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
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Reply to all the recipients using the --to and --cc options:
reply via email
To: pgsql-docs@postgresql.org
Cc: alvherre@2ndquadrant.com, davecramer@postgres.rocks, tgl@sss.pgh.pa.us, pgsql-docs@lists.postgresql.org
Subject: Re: documenting divergence from the SQL spec
In-Reply-To: <20200214165029.GA8387@alvherre.pgsql>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox