Re: psql's commit df9f599b is not documented - Mailing list 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@momjian.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@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  If only the physical world exists, free will is an illusion.