Re: PG 13 release notes, first draft

On Wed, May 13, 2020 at 07:18:38AM +0200, Fabien COELHO wrote:
>
> Hello Bruce,
>
> > > * e1ff780485
> >
> > I was told in this email thread to not include that one.
>
> Ok.
>
> > > * 34a0a81bfb
> >
> > We already have:
> >
> > Reformat tables containing function information for better
> > clarity (Tom Lane)
> >
> > so it seems it is covered as part of this.
>
> AFAICR this one is not by the same author, and although the point was about
> better clarity, it was not about formating but rather about restructuring
> text vs binary string function documentations. Then Tom reformatted the
> result.

Well, we were not even clear we should document changes in the functions
section, so going into details of all the changes seems unwise.

> > > * e829337d42
> >
> > Uh, this is a doc link formatting addition. I think this falls into the
> > error message logic, where it is nice when people want it, but they
> > don't need to know about it ahead of time.
>
> Hmmm. ISTM that this is not really about "error message logic", it is about
> navigating to libpq functions when one is reference in the description of
> another to check what it does, which I had to do a lot while developing some
> performance testing code for a project.

I don't see it.

> > > * "Document color support (Peter Eisentraut)"
> > > THIS WAS NOT DOCUMENTED BEFORE?
> > >
> > > Not as such, AFAICR it was vaguely hinted about in the documentation of
> > > command that would use it, but not even all of them. Now there is a new
> > > specific section.
> >
> > Again, this is the first hash you gave.
>
> Possibly, but as the "THIS WAS NOT DOCUMENTED BEFORE?" question seemed to
> still be in the release notes, I gathered that the information had not
> reached its destination, hence the possible repetition. But maybe the issue
> is that this answer is not satisfactory. Sorry for the inconvenience.

I removed it already based on feedback from someone else.

--
Bruce Momjian <bruce(at)momjian(dot)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 +