Should we still have old release notes in docs?

Started by Bruce Momjianabout 7 years ago7 messageshackers
Jump to latest
#1Bruce Momjian
bruce@momjian.us

I was just perusing our PDF docs for the first time in ages and
realized that of the 3,400+ pages of docs there's about 1,000 pages of
release notes in it.... That seems like a bit overkill.

I love having the old release notes online but perhaps they can be
somewhere other than the main docs? We could limit the current docs to
including the release notes for just the supported versions -- after
all you can always get the old release notes in the old docs
themselves.

--
greg

#2Andres Freund
andres@anarazel.de
In reply to: Bruce Momjian (#1)
Re: Should we still have old release notes in docs?

Hi,

On 2019-02-12 11:00:51 -0500, Greg Stark wrote:

I was just perusing our PDF docs for the first time in ages and
realized that of the 3,400+ pages of docs there's about 1,000 pages of
release notes in it.... That seems like a bit overkill.

I love having the old release notes online but perhaps they can be
somewhere other than the main docs? We could limit the current docs to
including the release notes for just the supported versions -- after
all you can always get the old release notes in the old docs
themselves.

You're behind the times, that just happened (in a pretty uncoordinated
manner).

Greetings,

Andres Freund

#3Tom Lane
tgl@sss.pgh.pa.us
In reply to: Andres Freund (#2)
Re: Should we still have old release notes in docs?

Andres Freund <andres@anarazel.de> writes:

On 2019-02-12 11:00:51 -0500, Greg Stark wrote:

I love having the old release notes online but perhaps they can be
somewhere other than the main docs? We could limit the current docs to
including the release notes for just the supported versions -- after
all you can always get the old release notes in the old docs
themselves.

You're behind the times, that just happened (in a pretty uncoordinated
manner).

Yeah, see 527b5ed1a et al.

The part about having a unified release-note archive somewhere else is
still WIP. The ball is in the web team's court on that, I think.

regards, tom lane

#4Dave Page
dpage@pgadmin.org
In reply to: Bruce Momjian (#1)
Re: Should we still have old release notes in docs?

On 12 Feb 2019, at 16:00, Greg Stark <stark@mit.edu> wrote:

I was just perusing our PDF docs for the first time in ages and
realized that of the 3,400+ pages of docs there's about 1,000 pages of
release notes in it.... That seems like a bit overkill.

I love having the old release notes online but perhaps they can be
somewhere other than the main docs? We could limit the current docs to
including the release notes for just the supported versions -- after
all you can always get the old release notes in the old docs
themselves

+1. It does seem excessive.

#5Jonathan S. Katz
jkatz@postgresql.org
In reply to: Tom Lane (#3)
Re: Should we still have old release notes in docs?

On Feb 12, 2019, at 5:12 PM, Tom Lane <tgl@sss.pgh.pa.us> wrote:

The part about having a unified release-note archive somewhere else is
still WIP. The ball is in the web team's court on that, I think.

Yes - we are going to try one thing with the existing way we load docs to try to avoid
additional structural changes. If that doesn’t work, we will reconvene
and see what we need to do.

Thanks,

Jonathan

#6Thomas Kellerer
shammat@gmx.net
In reply to: Tom Lane (#3)
Re: Should we still have old release notes in docs?

Tom Lane schrieb am 12.02.2019 um 17:12:

Yeah, see 527b5ed1a et al.

The part about having a unified release-note archive somewhere else is
still WIP. The ball is in the web team's court on that, I think.

The Bucardo team has already done that:

https://bucardo.org/postgres_all_versions.html

#7Jonathan S. Katz
jkatz@postgresql.org
In reply to: Jonathan S. Katz (#5)
Re: Should we still have old release notes in docs?

On 2/12/19 5:45 PM, Jonathan S. Katz wrote:

On Feb 12, 2019, at 5:12 PM, Tom Lane <tgl@sss.pgh.pa.us> wrote:

The part about having a unified release-note archive somewhere else is
still WIP. The ball is in the web team's court on that, I think.

Yes - we are going to try one thing with the existing way we load docs to try to avoid
additional structural changes. If that doesn’t work, we will reconvene
and see what we need to do.

I've proposed a patch for this here:

/messages/by-id/e0f09c9a-bd2b-862a-d379-601dfabc8969@postgresql.org

Thanks,

Jonathan