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 1gqh5T-0003Bz-Pg for pgsql-docs@arkaria.postgresql.org; Mon, 04 Feb 2019 16:27:11 +0000 Received: from localhost ([127.0.0.1] helo=malur.postgresql.org) by malur.postgresql.org with esmtp (Exim 4.89) (envelope-from ) id 1gqh5Q-0000CE-Ut for pgsql-docs@arkaria.postgresql.org; Mon, 04 Feb 2019 16:27:08 +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 1gqh5Q-0000C7-Ou for pgsql-docs@lists.postgresql.org; Mon, 04 Feb 2019 16:27:08 +0000 Received: from meldrar.postgresql.org ([2a02:c0:301:0:ffff::31]) by magus.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1gqh5O-0006Ch-UJ for pgsql-docs@lists.postgresql.org; Mon, 04 Feb 2019 16:27:08 +0000 Received: from [63.118.15.50] (helo=Ph33r-Retina.local) by meldrar.postgresql.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1gqh5L-0001p9-FW; Mon, 04 Feb 2019 16:27:06 +0000 Subject: Re: Release note trimming: another modest proposal To: Tom Lane Cc: Bruce Momjian , Magnus Hagander , Peter Eisentraut , pgsql-docs@lists.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> <18776.1549296730@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, 4 Feb 2019 11:26:59 -0500 User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.12; rv:60.0) Gecko/20100101 Thunderbird/60.5.0 MIME-Version: 1.0 In-Reply-To: <18776.1549296730@sss.pgh.pa.us> Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="ZTtiuX4C3IYMVutaRn0nLDwDh9umHp2uA" X-Host-Lookup-Failed: Reverse DNS lookup failed for 63.118.15.50 (failed) 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) --ZTtiuX4C3IYMVutaRn0nLDwDh9umHp2uA Content-Type: multipart/mixed; boundary="TwtpdW8WlXqsqsIPSxLsfeuHyD2gFd935"; protected-headers="v1" From: "Jonathan S. Katz" To: Tom Lane Cc: Bruce Momjian , Magnus Hagander , Peter Eisentraut , pgsql-docs@lists.postgresql.org Message-ID: Subject: Re: Release note trimming: another modest proposal 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> <18776.1549296730@sss.pgh.pa.us> In-Reply-To: <18776.1549296730@sss.pgh.pa.us> --TwtpdW8WlXqsqsIPSxLsfeuHyD2gFd935 Content-Type: text/plain; charset=windows-1252 Content-Language: en-US Content-Transfer-Encoding: quoted-printable On 2/4/19 11:12 AM, Tom Lane wrote: > "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). >=20 >> 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 r= eview. >=20 > 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. Thanks on all accounts. I reviewed and its along the lines of what I was thinking as well. The documentation in release.sgml on how to create things is clear. I did not try applying the patch, but syntactically it passes the eyeball test. > 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? Yeah, that was one of my first thoughts as I reviewed the patch. It's one of those "once-a-year" things that are easily forgotten (e.g. with EOL warnings, which is why we updated a few things around that). But as long as they're added to the process of wrapping for the release, it does not sound like its a huge burden. > 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. I guess one way to look at it: overhead of adding these additional changes vs. overhead saved with build times + tarball size? Are the extra X minutes of developer time worth it? >=20 > 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. Wow, 28-29% reduction in the file sizes, and 20% reduction in build time! Nice. Jonathan --TwtpdW8WlXqsqsIPSxLsfeuHyD2gFd935-- --ZTtiuX4C3IYMVutaRn0nLDwDh9umHp2uA Content-Type: application/pgp-signature; name="signature.asc" Content-Description: OpenPGP digital signature Content-Disposition: attachment; filename="signature.asc" -----BEGIN PGP SIGNATURE----- iQIzBAEBCAAdFiEE+oS2la8r95ogZD/x8QSccp8cZScFAlxYZ9MACgkQ8QSccp8c ZScbCw//VDoPqatntxk+xT5MnqjyOcMyvqSXb3Jg65/BS+c/cA1sNFOrEjc6UaNY B4OBTXEPfJylMI92rIGbb27Uz8bO6RF2wGr+94ldWeikwO6Cn6dqkRFHHkxRNhjI bgz5gYpASRSOJm1gFOFtXg3aAMxWyX2bn6as5TGnzm9arO9Obc7tAeZ4WWHQ9ZRA SzzcMUjtKKYbetixs8xiwox0eEfJKZS8uFUuJVm3cyostnAjT9MT9VDKcJHS+vo6 UZ8VG1iwqIoq0iuBlNBqsoZR3RunfWcnk6I9CXJ12C9FdwwpDZnKugYOlgcurDTq pmOLPLx2mak8Q92hL1zwlwYRaJFYNogJPNq5PYZC4T6ngt79YHdCfsxdLXO/WeQ4 lmRNIKl+mmn4qssIwOEOueHr7hhY/TqTy2ZaVvQJ6Dl57CyVB6lJKoDYaq6CRESq 2mkezNDt8vJh4hKqdPLPKVH8DdpsVUf+INi9NIMPSyPf0N9+QQbHGawJr4IIOV8q iU0VGg/WBvWx9QPGXGVFh97pGTNsicqNgEwPE78jlvd+65lIdO48l7UAdaeJVGvC QIyVXGIwLVsTUl1vWuDjntUHunO9Q7dGUlWWM7lkuqGUs10X/lOIJnVqL0ShzLNc X0ZoRdPAE1CAFH302O91/dFD3EfAFOP1KHERhTlaoo7/YSe7Ko4= =ZNI2 -----END PGP SIGNATURE----- --ZTtiuX4C3IYMVutaRn0nLDwDh9umHp2uA--