Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jWgwj-0000Qn-0D for pgsql-hackers@arkaria.postgresql.org; Thu, 07 May 2020 13:52:17 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.92) (envelope-from ) id 1jWgwh-0006Tj-U9 for pgsql-hackers@arkaria.postgresql.org; Thu, 07 May 2020 13:52:15 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.3:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jWgwh-0006Tc-N5 for pgsql-hackers@lists.postgresql.org; Thu, 07 May 2020 13:52:15 +0000 Received: from sss.pgh.pa.us ([66.207.139.130]) by magus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jWgwf-0001dW-IM for pgsql-hackers@postgresql.org; Thu, 07 May 2020 13:52:15 +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 047Dq8iD024480; Thu, 7 May 2020 09:52:08 -0400 From: Tom Lane To: Bruce Momjian cc: Fabien COELHO , PostgreSQL-development Subject: Re: PG 13 release notes, first draft In-reply-to: <20200507130804.GG3649@momjian.us> References: <20200505031600.GB21752@momjian.us> <20200505140055.GC21752@momjian.us> <20200506230750.GA3649@momjian.us> <20200507130804.GG3649@momjian.us> Comments: In-reply-to Bruce Momjian message dated "Thu, 07 May 2020 09:08:04 -0400" MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-ID: <24478.1588859528.1@sss.pgh.pa.us> Content-Transfer-Encoding: quoted-printable Date: Thu, 07 May 2020 09:52:08 -0400 Message-ID: <24479.1588859528@sss.pgh.pa.us> List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk Bruce Momjian writes: > On Thu, May 7, 2020 at 08:29:55AM +0200, Fabien COELHO wrote: >> After looking again at the release notes, I do really think that signif= icant >> documentation changes do not belong to the "Source code" section but sh= ould >> be in separate "Documentation" section, and that more items should be l= isted >> there, because they represent a lot of not-so-fun work, especially Tom'= s >> restructuration of tables, and possibly others. > Uh, can someone else give an opinion on this? I am not sure how hard or > un-fun an item is should be used as criteria. Historically we don't document documentation changes at all, do we? It seems (a) pointless and (b) circular. regards, tom lane