Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1j2dnH-0004Tn-Ou for pgsql-docs@arkaria.postgresql.org; Fri, 14 Feb 2020 16:26:19 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.89) (envelope-from ) id 1j2dnG-0006ux-Ck for pgsql-docs@arkaria.postgresql.org; Fri, 14 Feb 2020 16:26:18 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1j2dnG-0006up-1S for pgsql-docs@lists.postgresql.org; Fri, 14 Feb 2020 16:26:18 +0000 Received: from sss.pgh.pa.us ([66.207.139.130]) by makus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1j2dnD-0007ME-FR for pgsql-docs@lists.postgresql.org; Fri, 14 Feb 2020 16:26:16 +0000 Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1]) by sss.pgh.pa.us (8.14.4/8.14.4) with ESMTP id 01EGQDoM012154; Fri, 14 Feb 2020 11:26:13 -0500 From: Tom Lane To: Dave Cramer cc: pgsql-docs@lists.postgresql.org Subject: Re: documenting divergence from the SQL spec In-reply-to: References: Comments: In-reply-to Dave Cramer message dated "Fri, 14 Feb 2020 11:05:25 -0500" MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-ID: <12152.1581697573.1@sss.pgh.pa.us> Content-Transfer-Encoding: quoted-printable Date: Fri, 14 Feb 2020 11:26:13 -0500 Message-ID: <12153.1581697573@sss.pgh.pa.us> List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk Dave Cramer writes: > We have a section in the main docs for conformance > https://www.postgresql.org/docs/12/features.html > And then this https://wiki.postgresql.org/wiki/PostgreSQL_vs_SQL_Standar= d for > divergence. > I'd like to see the divergence section put into the main docs so that it= is > easier to find. The individual statement reference pages already have sections for standards divergences. Admittedly, that framework doesn't help for discrepancies that can't be tied to a statement type ... but I don't think we should throw in duplicative material of this sort. It's tough enough to keep one instance of the info up-to-date. So I'd want to see some structure for this that respects that existing set of information. regards, tom lane