Re: Proposal for changes to recovery.conf API

On Fri, Dec 9, 2016 at 9:34 AM, Josh Berkus <josh(at)agliodbs(dot)com> wrote:
> On 12/08/2016 04:16 PM, Tom Lane wrote:
>> Josh Berkus <josh(at)agliodbs(dot)com> writes:
>>> On 12/01/2016 05:58 PM, Magnus Hagander wrote:
>>>> And in fairness, having such a "guide to changes" chapter in each
>>>> release probably *would* be a good idea. But it would take resources to
>>>> make that. The release notes are good, but having a more hand-holding
>>>> version explaining incompatible changes in "regular sentences" would
>>>> probably be quite useful to users.
>>
>>> We will have enough major changes in 10.0 to warrant writing one of
>>> these. Maybe not as part of the official docs, but as a set of wiki
>>> pages or similar.
>>
>> Seems to me this is exactly the release notes' turf. If you think the
>> release notes aren't clear enough, step right up and help improve them.
>>
>> My own take on it is that the release notes are already a massive
>> amount of work, and putting duplicative material in a bunch of other
>> places isn't going to make things better, it'll just increase the
>> maintenance burden.
>
> This would mean adding literally pages of material to the release notes.
> In the past, folks have been very negative on anything which would make
> the release notes longer. Are you sure?

As that's a per-version information, that seems adapted to me. There
could be as well in the release notes a link to the portion of the
docs holding this manual. Definitely this should be self-contained in
the docs, and not mention the wiki. My 2c.
--
Michael