Re: Add docs stub for recovery.conf

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.

In response to

Browse pgsql-hackers by date

  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