Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1gqgrE-0002EY-IM for pgsql-docs@arkaria.postgresql.org; Mon, 04 Feb 2019 16:12:28 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.89) (envelope-from ) id 1gqgrD-0000E9-18 for pgsql-docs@arkaria.postgresql.org; Mon, 04 Feb 2019 16:12:27 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1gqgrC-0000E1-RG for pgsql-docs@lists.postgresql.org; Mon, 04 Feb 2019 16:12:26 +0000 Received: from sss.pgh.pa.us ([66.207.139.130]) by magus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1gqgr4-0005sw-VJ for pgsql-docs@lists.postgresql.org; Mon, 04 Feb 2019 16:12:26 +0000 Received: from sss1.sss.pgh.pa.us (localhost [127.0.0.1]) by sss.pgh.pa.us (8.14.4/8.14.4) with ESMTP id x14GCACf018777; Mon, 4 Feb 2019 11:12:10 -0500 From: Tom Lane To: "Jonathan S. Katz" cc: Bruce Momjian , Magnus Hagander , Peter Eisentraut , pgsql-docs@lists.postgresql.org Subject: Re: Release note trimming: another modest proposal In-reply-to: <402d07a0-227b-71b7-0ecd-0b6c379e3cd0@postgresql.org> References: <19252.1533509841@sss.pgh.pa.us> <20190125233111.GE13803@momjian.us> <16080.1548459680@sss.pgh.pa.us> <20190125234614.GH13803@momjian.us> <8fd2ae88-49de-26f3-def3-e4381cb7e774@postgresql.org> <21920.1548515166@sss.pgh.pa.us> <402d07a0-227b-71b7-0ecd-0b6c379e3cd0@postgresql.org> Comments: In-reply-to "Jonathan S. Katz" message dated "Sat, 26 Jan 2019 10:25:04 -0500" MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="----- =_aaaaaaaaaa0" Content-ID: <18632.1549296554.0@sss.pgh.pa.us> Date: Mon, 04 Feb 2019 11:12:10 -0500 Message-ID: <18776.1549296730@sss.pgh.pa.us> List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk ------- =_aaaaaaaaaa0 Content-Type: text/plain; charset="us-ascii" Content-ID: <18632.1549296554.1@sss.pgh.pa.us> "Jonathan S. Katz" writes: > On 1/26/19 10:06 AM, Tom Lane wrote: >> If I haven't heard objections, I'll see about making this happen >> during the first week of Feb (after the CF closes, but before >> it's time to do the February releases' notes). > Thank you! I was hoping to take a crack at doing this, but I would not > be able to do so in the above timeline. However, I should be able to review. Attached is a diff showing what I'm thinking about, for HEAD; each active back branch would get a similar change. I'd also "git rm" now-unreferenced files in relevant branches, but that'd just bulk up the diff so I've not shown it here. 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? Note that this would change our workflow for release notes a bit, in that real editing work would happen in the back branches, rather than them just getting copies of text from HEAD. I don't see a big problem there, but it's a bit different from how we've traditionally done things. Just for the record, this change causes the time to build HEAD's HTML documentation to drop from ~120 sec to ~95 sec for me; the size of the resulting html/ directory drops from 21MB to 15MB, while the PDF output goes from 17MB to 12.2MB. I didn't try to measure the impact on tarball size, but it should be noticeable. regards, tom lane ------- =_aaaaaaaaaa0 Content-Type: text/x-diff; name="delete-old-release-notes-HEAD.patch"; charset="us-ascii" Content-ID: <18632.1549296554.2@sss.pgh.pa.us> Content-Description: delete-old-release-notes-HEAD.patch diff --git a/doc/src/sgml/filelist.sgml b/doc/src/sgml/filelist.sgml index 5dfdf54..a03ea14 100644 --- a/doc/src/sgml/filelist.sgml +++ b/doc/src/sgml/filelist.sgml @@ -166,22 +166,6 @@ - - - - - - - - - - - - - - - - diff --git a/doc/src/sgml/release.sgml b/doc/src/sgml/release.sgml index 4055adf..cd12e1b 100644 --- a/doc/src/sgml/release.sgml +++ b/doc/src/sgml/release.sgml @@ -70,27 +70,78 @@ For new features, add links to the documentation sections. + &release-12; -&release-11; -&release-10; -&release-9.6; -&release-9.5; -&release-9.4; -&release-9.3; -&release-9.2; -&release-9.1; -&release-9.0; -&release-8.4; -&release-8.3; -&release-8.2; -&release-8.1; -&release-8.0; -&release-7.4; -&release-old; + + + Prior Releases + + + Release notes for currently-supported previous release series can be + found at: + + + + + PostgreSQL 11: + + https://www.postgresql.org/docs/11/release.html + + + + + + + PostgreSQL 10: + + https://www.postgresql.org/docs/10/release.html + + + + + + + PostgreSQL 9.6: + + https://www.postgresql.org/docs/9.6/release.html + + + + + + + PostgreSQL 9.5: + + https://www.postgresql.org/docs/9.5/release.html + + + + + + + PostgreSQL 9.4: + + https://www.postgresql.org/docs/9.4/release.html + + + + + + + + Release notes for out-of-support release series can be found at + + https://www.postgresql.org/docs/manuals/archive/ + + + ------- =_aaaaaaaaaa0--