From: | "David G(dot) Johnston" <david(dot)g(dot)johnston(at)gmail(dot)com> |
---|---|
To: | Bruce Momjian <bruce(at)momjian(dot)us> |
Cc: | Craig Ringer <craig(dot)ringer(at)enterprisedb(dot)com>, pgsql-hackers <pgsql-hackers(at)postgresql(dot)org> |
Subject: | Re: Add docs stub for recovery.conf |
Date: | 2020-11-11 19:57:49 |
Message-ID: | CAKFQuwZ3GuCwOdx2E_DO7FSh4SEv-xn-5u9pOvKYyfH0rn_HHQ@mail.gmail.com |
Views: | Raw Message | Whole Thread | Download mbox | Resend email |
Thread: | |
Lists: | pgsql-hackers |
On Wed, Nov 11, 2020 at 12:44 PM Bruce Momjian <bruce(at)momjian(dot)us> wrote:
> On Tue, Nov 10, 2020 at 01:38:14PM +0800, Craig Ringer wrote:
> > Hi all
> >
> > I noticed that when recovery.conf was removed in 2dedf4d9a8 (yay!) the
> docs for
> > it were removed completely as well. That's largely sensible, but is
> confusing
> > when users have upgraded and are trying to find out what happened, or
> how to
> > configure equivalent functionality.
>
> I don't see the logic in carrying doc stuff that we don't have anymore.
>
>
I do. Saying why something went away has value. For small stuff you have
commit messages. For user-facing documentation stuff that warranted its
own page, having said page remain and describe the change seems worthwhile.
David J.
From | Date | Subject | |
---|---|---|---|
Next Message | Daniel Gustafsson | 2020-11-11 19:59:40 | Re: Add docs stub for recovery.conf |
Previous Message | Tomas Vondra | 2020-11-11 19:52:56 | Re: Parallel bitmap index scan |