Re: PG 13 release notes, first draft

[Bruce Momjian]

On Mon, May 11, 2020 at 10:23:53PM -0400, Tom Lane wrote:
> Bruce Momjian <br...@momjian.us> writes:
> > Well, are you suggesting a new section because the glossary shouldn't be
> > listed under source code, or because you want the function reformatting
> > added?  We just need to understand what the purpose is.  We already have
> > the glossary listed, since that is new and user-visible.
> 
> The implication of what you say here is that "is it user-visible?"
> is a criterion for whether to release-note something.  By that logic
> we probably *should* relnote the function table layout changes, because
> they sure as heck are user-visible.  People might or might not notice
> addition of a glossary, but I think just about every user consults
> the function/operator tables regularly.
> 
> I concur with Alvaro's position that if we are listing documentation
> changes, pushing them under "Source Code" is not the way to do it.
> That subsection has always been understood to be "stuff you don't
> care about if you're not a hacker".
> 
> So that sort of leads me to the conclusion that "major documentation
> changes" might be a reasonable sub-heading for the release notes.

OK, section and item added, patch attached,

-- 
  Bruce Momjian  <br...@momjian.us>        https://momjian.us
  EnterpriseDB                             https://enterprisedb.com

+ As you are, so once was I.  As I am, so you will be. +
+                      Ancient Roman grave inscription +

diff --git a/doc/src/sgml/release-13.sgml b/doc/src/sgml/release-13.sgml
index 83470e9ba1..34211e2b68 100644
--- a/doc/src/sgml/release-13.sgml
+++ b/doc/src/sgml/release-13.sgml
@@ -2331,7 +2331,7 @@ Use the directory of the pg_upgrade binary as the default new 'bindir' location
    </sect3>
 
    <sect3>
-    <title>Source Code</title>
+    <title>Documentation</title>
 
     <itemizedlist>
 
@@ -2347,6 +2347,27 @@ Add a glossary to the documentation (Corey Huinker, J&uuml;rgen Purtz, Roger Har
 
 </listitem>
 
+<listitem>
+<!--
+Author: Tom Lane <t...@sss.pgh.pa.us>
+2020-04-12 [e894c6183] Doc: introduce new layout for tables of functions and op
+-->
+
+<para>
+Reformat tables containing function information for better clarity (Tom Lane)
+</para>
+
+</listitem>
+
+    </itemizedlist>
+
+   </sect3>
+
+   <sect3>
+    <title>Source Code</title>
+
+    <itemizedlist>
+
 <listitem>
 <!--
 Author: Peter Eisentraut <pe...@eisentraut.org>