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

From Jonathan S. Katz
Subject Re: pgsql: Doc: fill in "major enhancements" list in v13 release notes.
Date
Msg-id eaed127d-39b1-ae47-4891-6d0b1b5d8653@postgresql.org
Whole thread Raw
In response to Re: pgsql: Doc: fill in "major enhancements" list in v13 release notes.  (Tom Lane <tgl@sss.pgh.pa.us>)
Responses Re: pgsql: Doc: fill in "major enhancements" list in v13 release notes.
List pgsql-www
On 9/14/20 9:58 AM, Tom Lane wrote:
> [ redirecting to -www ]
>
> Magnus Hagander <magnus@hagander.net> writes:
>> On Mon, Sep 14, 2020 at 3:28 PM Andrew Dunstan <
>> andrew.dunstan@2ndquadrant.com> wrote:
>>> How is it that this commit still hasn't showed up on the web site, 4
>>> days later? <https://www.postgresql.org/docs/13/release-13.html> still
>>> shows "TBD"
>
>> The  "13" docs are only loaded along with releases, we don't load snapshot
>> versions into the docs other than the "devel" ones. That is, from a loading
>> perspective, 13 is treated the same as 12 or 11.
>
> Yeah, this is a downside of our decision to maintain release notes
> per-branch.  It used to be you could count on draft release notes to
> show up in the website's devel docs fairly quickly; but now they
> never appear there at all.
>
> I've wondered if we could improve that.  I agree with the policy that
> the official docs copy should match the last official release ... but
> maybe we could show unreleased release notes somewhere else, such as
> under https://www.postgresql.org/docs/release/ ?

Like these?

https://www.postgresql.org/docs/devel/release-14.html

Based on how it currently works, we'd have to update the logic to
include the devel docs, but those don't appear to include much, per the
comments above.

Otherwise, we'd have to take a special snapshot of just the beta line
(which we might do in the buildfarm?), load those into the website, then
display it.

It's possible, but it's no free lunch as we'd have to change a few
things to accommodate that.

I guess the question is how useful would it be to have it? I haven't had
a chance to look into the numbers about the general traffic to the PG13
release notes and the traffic to the release notes page as well, so this
is purely qualitative at this point.

Jonathan


Attachment

pgsql-www by date:

Previous
From: Daniel Gustafsson
Date:
Subject: Re: postgr.es/p/githash to redirect to git.postgresql.org?
Next
From: Magnus Hagander
Date:
Subject: Re: pgsql: Doc: fill in "major enhancements" list in v13 release notes.