Re: Release note trimming: another modest proposal

From: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
To: "Jonathan S(dot) Katz" <jkatz(at)postgresql(dot)org>
Cc: Bruce Momjian <bruce(at)momjian(dot)us>, Magnus Hagander <magnus(at)hagander(dot)net>, Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>, pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: Release note trimming: another modest proposal
Date: 2019-02-04 21:25:49
Message-ID: 31322.1549315549@sss.pgh.pa.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

"Jonathan S. Katz" <jkatz(at)postgresql(dot)org> writes:
> On 2/4/19 11:12 AM, Tom Lane wrote:
>> It's not quite clear to me what the policy would be for removing
>> back-branch links from this list when old versions drop out of support.
>> Should we go back and remove them in surviving back branches, or just
>> change HEAD?

> Yeah, that was one of my first thoughts as I reviewed the patch. It's
> one of those "once-a-year" things that are easily forgotten (e.g. with
> EOL warnings, which is why we updated a few things around that). But as
> long as they're added to the process of wrapping for the release, it
> does not sound like its a huge burden.

After a bit more thought, I'm inclined to propose that the policy be
that we *don't* update the surviving back branches for branch retirement.
The new wording in release.sgml should be adjusted to clarify this,
along the lines of

Release notes for prior release branches can be found on the
PostgreSQL web site. At the time of release of version 12,
these were the supported prior release branches:

<list of direct links, as before>

Release notes for older branches can be found at
<link to docs/manuals/archive/>.

In this way, the prior-release notes section just provides some handy
links for recent past releases, and isn't purporting to offer
up-to-the-minute info on what's in support.

regards, tom lane

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Jonathan S. Katz 2019-02-04 22:13:21 Re: Release note trimming: another modest proposal
Previous Message Jonathan S. Katz 2019-02-04 16:26:59 Re: Release note trimming: another modest proposal