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 1gggye-0001yR-PD for pgsql-docs@arkaria.postgresql.org; Tue, 08 Jan 2019 02:18:48 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.89) (envelope-from ) id 1gggyb-0000Ky-Nv for pgsql-docs@arkaria.postgresql.org; Tue, 08 Jan 2019 02:18:45 +0000 Received: from makus.postgresql.org ([2001:4800:3e1:1::229]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1gggyb-0000Kq-EC for pgsql-docs@lists.postgresql.org; Tue, 08 Jan 2019 02:18:45 +0000 Received: from meldrar.postgresql.org ([2a02:c0:301:0:ffff::31]) by makus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1gggyW-0004Bf-PU for pgsql-docs@lists.postgresql.org; Tue, 08 Jan 2019 02:18:43 +0000 Received: from pool-96-250-83-19.nycmny.fios.verizon.net ([96.250.83.19] helo=Ph33r-Retina.home) by meldrar.postgresql.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1gggyS-0006Tp-Iy; Tue, 08 Jan 2019 02:18:39 +0000 Subject: Re: Release note trimming: another modest proposal To: Magnus Hagander , Peter Eisentraut Cc: Tom Lane , pgsql-docs@lists.postgresql.org References: <19252.1533509841@sss.pgh.pa.us> From: "Jonathan S. Katz" Openpgp: preference=signencrypt Autocrypt: addr=jkatz@postgresql.org; keydata= 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 FmEC Message-ID: Date: Mon, 7 Jan 2019 21:18:29 -0500 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.12; rv:60.0) Gecko/20100101 Thunderbird/60.4.0 MIME-Version: 1.0 In-Reply-To: Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="7xSX9UwwPozQUfJxyb28p6QGlQIstCVJ8" List-Id: List-Help: List-Subscribe: List-Post: List-Owner: List-Archive: Precedence: bulk This is an OpenPGP/MIME signed message (RFC 4880 and 3156) --7xSX9UwwPozQUfJxyb28p6QGlQIstCVJ8 Content-Type: multipart/mixed; boundary="3zfpRjrdNNP4jlQrDw0DLhjYxuMlFWSBB"; protected-headers="v1" From: "Jonathan S. Katz" To: Magnus Hagander , Peter Eisentraut Cc: Tom Lane , pgsql-docs@lists.postgresql.org Message-ID: Subject: Re: Release note trimming: another modest proposal References: <19252.1533509841@sss.pgh.pa.us> In-Reply-To: --3zfpRjrdNNP4jlQrDw0DLhjYxuMlFWSBB Content-Type: text/plain; charset=utf-8 Content-Language: en-US Content-Transfer-Encoding: quoted-printable On 8/30/18 4:15 PM, Magnus Hagander wrote: > On Fri, Aug 10, 2018 at 1:38 AM, Peter Eisentraut > > wrote: >=20 > On 06/08/2018 00:57, Tom Lane wrote: > > Anyway, I'd like to propose a compromise position that I don't th= ink > > has been discussed before: let's drop release notes for branches > > that were already EOL when a given branch was released.=C2=A0 So = for > > example, 9.3 and before would go away from v12, due out next year= =2E > > Working backwards, we'd drop 9.1 and before from v10, giving the = 15% > > savings in page count that I showed above.=C2=A0 A quick measurem= ent says > > that would also trim the size of the v10 tarball by about 4%, whi= ch > > is not a lot maybe but it's noticeable across a lot of downloads.= >=20 > Why not go further and just ship the release notes of the current m= ajor > version.=C2=A0 If you want to look at the release notes of version = 11, read > the documentation for version 11.=C2=A0 Who reads the documentation= of > version 12 to get the release notes of version 11? >=20 >=20 > +1 for that. At least if we get a generic release notes index up on the= > website, easy to find. So circling back on this, Peter's point makes a lot of sense. If you want to see release notes for other major versions, there would be URLs to the other major versions, but that would be far less costly than keeping the actual release notes in each tarball. So for example, let's take PostgreSQL 11: https://www.postgresql.org/docs/11/release.html We could do something like: =3D=3Dsnip=3D=3D - Release 11.1 Migration to Version 11.1 Changes - Release 11.0 Migration to Version 11.1 Changes Older Major Versions: PostgreSQL 10 [URL to https://www.postgresql.org/docs/10/release.html] PostgreSQL 9.6 [URL to https://www.postgresql.org/docs/9.6/release.html] etc. etc. =3D=3D snip =3D=3D That would both save significant space and hopefully solve the archiving problem, as we would have the older docs available with all of their respective versions. The downside would be the PDFs, you would not have all the release notes for, say PostgreSQL 10, in the PostgreSQL 11 PDFs. But I would argue does that really matter? I could see that being helpful if you're migrating between versions, but if you're using PostgreSQL 11, you're using PostgreSQL 11 and the information for that version is the most relevant. It also seems like it'd make it easier to maintain the release notes too, which would be another big win in addition to the build speedup. Thoughts? Jonathan --3zfpRjrdNNP4jlQrDw0DLhjYxuMlFWSBB-- --7xSX9UwwPozQUfJxyb28p6QGlQIstCVJ8 Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEE+oS2la8r95ogZD/x8QSccp8cZScFAlw0CHUACgkQ8QSccp8c ZSfEfRAAuqwCcz3x92tYEfWeAIPGIsZSFgjGW2bxTpYJKVsOFrmef4bGXnbcRhz+ bmPqbwqFUtvIjB2yQyC/SZ4ZYUxJUxO7ayCnejrlDJL/CnmHjBNzFpGr2YIw6tZc IzPsJo4Pp2A8aaBIoTV/dJu4Qnz+HlQjaT6u3YvODVistn/rqEd5i3dn7XRSfztZ H7eGE87oW1WJYbFKTxIv5NAw8fuvbmqYfAKl10snBxNOINzr//WJND71YfOpVGeA RadP7otXn2KixGLxHCtbBAlcb1FPw9PQz53mE/S6wT9Zh1URr7nbVq2J7f5s5epf 1Ur3oMZJ34Y6aXjvI6+gnYChUu3T+3rRUzQnsYXCXs3dOFr+FJl5Bm4YrgSOjAfx kUZyFKc/zpzOsQLUvNbV5RY+hwe2c/4iP6qNZAALPgPPHeQMcw2VOASha9D6ZV8S 7DshUITcjflCFrFEUzfM3QWgLACuxDH4l9rtFe5BELVFm2/nqgdTNFGwLnSHL3if 77PnJc3AUjXJyxOyeFKxJEsqKQDEdxn7BCG6BsWYiK5boJF0qd/h+JHuIMa2mnHG n33qE3rjD9dO2lzOb+dWI7UsbKGnUWG2chLL99Uj5LjAIr2qaVTi8peRcWTsNEgB 8OAH+M31T+8/DVk8FyFrq5qDY+kisSzrPnn0LIofPoRO4McgtCk= =7eSU -----END PGP SIGNATURE----- --7xSX9UwwPozQUfJxyb28p6QGlQIstCVJ8--