Re: Release note trimming: another modest proposal

From: Bruce Momjian <bruce(at)momjian(dot)us>
To: Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us>
Cc: 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: 2018-08-10 01:01:31
Message-ID: 20180810010131.GB32075@momjian.us
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Thu, Aug 9, 2018 at 07:45:08PM -0400, Tom Lane wrote:
> Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com> writes:
> > On 06/08/2018 00:57, Tom Lane wrote:
> >> Anyway, I'd like to propose a compromise position that I don't think
> >> has been discussed before: let's drop release notes for branches
> >> that were already EOL when a given branch was released.
>
> > Why not go further and just ship the release notes of the current major
> > version. If you want to look at the release notes of version 11, read
> > the documentation for version 11. Who reads the documentation of
> > version 12 to get the release notes of version 11?
>
> Personally, I'd be OK with that, but it seemed to me that that had
> already been proposed and shot down (on the grounds of not-enough-
> history) the last time this was discussed.

We allow people to just several major versions as long as they read the
release notes of all the versions they skipped. Shipping all active
major version release notes works for that.

Personally, I would find a git tree or tarball of all release notes in
SGML or HTML format useful.

--
Bruce Momjian <bruce(at)momjian(dot)us> http://momjian.us
EnterpriseDB http://enterprisedb.com

+ As you are, so once was I. As I am, so you will be. +
+ Ancient Roman grave inscription +

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message KES 2018-08-10 09:10:47 Re: Typo in doc or wrong EXCLUDE implementation
Previous Message Tom Lane 2018-08-09 23:45:08 Re: Release note trimming: another modest proposal