Re: pgsql: Doc: fill in "major enhancements" list in v13 release notes.

From: "Jonathan S(dot) Katz" <jkatz(at)postgresql(dot)org>
To: Andrew Dunstan <andrew(dot)dunstan(at)2ndquadrant(dot)com>, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>, Magnus Hagander <magnus(at)hagander(dot)net>
Cc: PostgreSQL WWW <pgsql-www(at)lists(dot)postgresql(dot)org>
Subject: Re: pgsql: Doc: fill in "major enhancements" list in v13 release notes.
Date: 2020-09-14 16:57:48
Message-ID: 582bcf4e-6274-6aa3-473f-526b57b6ec7f@postgresql.org
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-committers pgsql-www

On 9/14/20 11:54 AM, Andrew Dunstan wrote:
>
> On 9/14/20 11:25 AM, Tom Lane wrote:
>> Magnus Hagander <magnus(at)hagander(dot)net> writes:
>>> Well the question is, does this really apply only to the release notes.
>>> What about other changes that are made to the documentation in-between
>>> releases?
>>> Perhaps we actually want a complete separate docs-load, including back
>>> branches, that just gets hidden away somewhere and smacked full of labels
>>> that it's not a production set of documentation etc? That would then cover
>>> both release notes and reviews of other docs backpatching.
>> Yeah, that's quite a plausible proposal.
>>
>>
>
>
>
> Seems fair.

For my 2¢ -- my use case is that I typically have to read the release
notes prior to an update announcement (nevermind major release) and turn
it into...an update announcement.

What I've done as of late is that I check out whatever the latest stable
branch is and build the docs locally using the HTML styles, and read
them that way. That seem to work fine. It adds about 2-3 minutes to my
workflow, but for the frequency at which I have to do that, it's not all
that painful.

Would going to a URL make it easier? Sure. Is it worth the effort we'd
likely put Magnus, and possibly myself, through to make it easier? I
don't know.

Jonathan

In response to

Responses

Browse pgsql-committers by date

  From Date Subject
Next Message Tom Lane 2020-09-14 17:11:47 Re: pgsql: Doc: fill in "major enhancements" list in v13 release notes.
Previous Message Tom Lane 2020-09-14 16:35:08 pgsql: Make walsenders show their replication commands in pg_stat_activ

Browse pgsql-www by date

  From Date Subject
Next Message Tom Lane 2020-09-14 17:11:47 Re: pgsql: Doc: fill in "major enhancements" list in v13 release notes.
Previous Message Andrew Dunstan 2020-09-14 15:54:30 Re: pgsql: Doc: fill in "major enhancements" list in v13 release notes.