Re: psql's commit df9f599b is not documented

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.

In response to

Responses

Browse pgsql-docs by date

  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