| 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: | Whole Thread | Raw Message | 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 |