From: | Bruce Momjian <bruce(at)momjian(dot)us> |
---|---|
To: | "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com> |
Cc: | mali_86(at)outlook(dot)com, Pg Docs <pgsql-docs(at)lists(dot)postgresql(dot)org> |
Subject: | Re: psql's commit df9f599b is not documented |
Date: | 2021-08-03 00:56:02 |
Message-ID: | 20210803005602.GB3639@momjian.us |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-docs |
On Mon, Aug 2, 2021 at 05:24:14PM -0700, David G. Johnston wrote:
> On Mon, Aug 2, 2021 at 5:03 PM Bruce Momjian <bruce(at)momjian(dot)us> wrote:
>
>
> I think we put it in the PG 11 release notes so people who used Postgres
> previously would know this item is improved, but for new folks, it will
> just work if they try it, but we don't want to encourage them to try it.
>
>
>
> And why do we care about informing people those people of this undocumented
> behavior? It's not like we want to encourage them to use it either.
>
> I stand by my conviction that a release note entry for a user-visible feature
> requires having documented said feature in the main documentation - and
> vice-versa.
We had a long discussion about this in the PG 11 time frame and that was
what was decided.
--
Bruce Momjian <bruce(at)momjian(dot)us> https://momjian.us
EDB https://enterprisedb.com
If only the physical world exists, free will is an illusion.
From | Date | Subject | |
---|---|---|---|
Next Message | Dave Cramer | 2021-08-03 10:39:21 | Re: psql's commit df9f599b is not documented |
Previous Message | David G. Johnston | 2021-08-03 00:24:14 | Re: psql's commit df9f599b is not documented |