Magnus Hagander <magnus@hagander.net> writes:
>> On 9/14/20 9:58 AM, Tom Lane wrote:
>>> 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/ ?
> Given that we only have one branch that is in the state of "labeled a
> stable branch but it's not really a stable branch yet", and only for a few
> months in the year, it seems doing that manually might well be acceptable?
There are actually two somewhat separate use-cases here:
* Draft release notes for a pending major release.
* Draft release notes for minor releases.
In both cases, Bruce or I push some notes into the git tree, but there
is noplace for potential reviewers to look at a built version of the
notes. Reviewers must either read the raw SGML or build the docs
themselves. The situation was better before the release notes branch
split, because you could look at the devel version of the docs.
I agree that this is not something we need to expend cycles on on any
regular basis. Personally I'd be happy to manually push a button
somewhere after committing a relnotes update. The real issue though
is where does this show up on the website? Since, by definition,
we're talking about unreleased documentation, I don't think it
should replace the normal docs for the relevant branch.
regards, tom lane