Date: Mon, 2 Aug 2021 20:56:02 -0400
From: Bruce Momjian <bruce@momjian.us>
To: "David G. Johnston" <david.g.johnston@gmail.com>
Cc: mali_86@outlook.com, Pg Docs <pgsql-docs@lists.postgresql.org>
Subject: Re: psql's commit df9f599b is not documented
Message-ID: <20210803005602.GB3639@momjian.us>
References: <162794046650.25749.16629649309696437240@wrigleys.postgresql.org>
 <CAKFQuwYddkFFAojWojCLjKb8Uq-BEXfX3O6fCPYOAB4SLtn20A@mail.gmail.com>
 <20210802230959.GA7858@momjian.us>
 <CAKFQuwYS2H1Q6wwy33G+aERP5Y58kMeiZ0x9TpCx=qDN=KvROw@mail.gmail.com>
 <20210803000350.GA3639@momjian.us>
 <CAKFQuwZjzhj2THbxKueK6g7V2_1n7xCkSxB2AbUpJTNXFiL1HA@mail.gmail.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: 
 <CAKFQuwZjzhj2THbxKueK6g7V2_1n7xCkSxB2AbUpJTNXFiL1HA@mail.gmail.com>
User-Agent: Mutt/1.10.1 (2018-07-13)
Archived-At: 
 <https://www.postgresql.org/message-id/20210803005602.GB3639%40momjian.us>
Precedence: bulk

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.