On Mon, May 11, 2020 at 10:23:53PM -0400, Tom Lane wrote:
> Bruce Momjian <bruce@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 <bruce@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 +