pg.ddx.io  pgsql-docs@postgresql.org mailing list archive  

help / color / mirror / Atom feed
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
Date: Mon, 2 Aug 2021 20:56:02 -0400
Message-ID: <20210803005602.GB3639@momjian.us> (raw)
In-Reply-To: <CAKFQuwZjzhj2THbxKueK6g7V2_1n7xCkSxB2AbUpJTNXFiL1HA@mail.gmail.com>
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>

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.






view thread (11+ messages)  latest in thread

Message-ID: <20210803005602.GB3639@momjian.us>
Permalink:  ../20210803005602.GB3639@momjian.us/
Also on:    postgresql.org/message-id/20210803005602.GB3639@momjian.us

 · 

reply
Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: pgsql-docs@postgresql.org
  Cc: bruce@momjian.us, david.g.johnston@gmail.com, pgsql-docs@lists.postgresql.org
  Subject: Re: psql's commit df9f599b is not documented
  In-Reply-To: <20210803005602.GB3639@momjian.us>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox