Path: csiph.com!newsfeed.xs4all.nl!newsfeed8.news.xs4all.nl!news.dns-netz.com!news.freedyn.net!aioe.org!bofh.it!news.nic.it!robomod From: Thomas Goirand Newsgroups: linux.debian.maint.python Subject: Re: How to watch pypi.org Date: Sun, 01 Nov 2020 20:30:02 +0100 Message-ID: References: X-Mailbox-Line: From debian-python-request@lists.debian.org Sun Nov 1 19:23:39 2020 Old-Return-Path: X-Amavis-Spam-Status: No, score=-7.157 tagged_above=-10000 required=5.3 tests=[BAYES_00=-2, LDO_WHITELIST=-5, MURPHY_SCAM1=0.1, NICE_REPLY_A=-0.257] autolearn=ham autolearn_force=no X-Policyd-Weight: using cached result; rate: -3.5 Organization: Debian User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.4.0 MIME-Version: 1.0 Content-Type: text/plain; charset=windows-1252 Content-Language: en-US Content-Transfer-Encoding: 7bit X-Mailing-List: archive/latest/18763 List-ID: List-URL: List-Archive: https://lists.debian.org/msgid-search/ef0ce71a-24ea-ac30-9027-fceb2b2e6829@debian.org Approved: robomod@news.nic.it Lines: 52 Sender: robomod@news.nic.it X-Original-Date: Sun, 1 Nov 2020 20:23:20 +0100 X-Original-Message-ID: X-Original-References: <20201031121021.5d6pmpujxf4zamsp@yuggoth.org> Xref: csiph.com linux.debian.maint.python:12999 On 10/31/20 1:10 PM, Jeremy Stanley wrote: > On 2020-10-31 12:03:50 +0100 (+0100), Thomas Goirand wrote: > [...] >> On 10/31/20 3:07 AM, Jeremy Stanley wrote: >>> I have to agree, though in the upstream projects with which I'm >>> involved, those generated files are basically a lossy re-encoding of >>> metadata from the Git repositories themselves: AUTHORS file >>> generated from committer headers, ChangeLog files from commit >>> subjects, version information from tag names, and so on. Some of >>> this information may be referenced from copyright licenses, so it's >>> important in those cases for package maintainers to generate it when >>> making their source packages if not using the sdist tarballs >>> published by the project. >> >> Unfortunately, the FTP masters do not agree with you. I've been told >> that the OpenStack changelog is a way too big, and it's preferable to >> not have it in the binary packages. > > PBR started creating much smaller changelogs years ago, after you > asked ftpmaster. I get that you see no value in changelog files, but > it seems like it would be worth revisiting. Probably it'd be worth revisiting indeed, especially by finding a way to push the logs only in the relevant -doc packages. Maybe by using the same kind of trick which I want to do with the release notes (see below), ie storing these files in the debian folder. However, if I am to put more efforts on stuff like that, my priority would be first on getting the reno release notes published in the Debian package. I've been thinking about this for a long time, and haven't figured out yet what would be the best way, with a reasonable workflow. >From the Debian perspective, I'd have to: - generate the release notes from the last version in Debian Stable, up to what's in Sid. For example, I would include all the OpenStack release notes for Stein, Train, Ussuri and Victoria in all packages uploaded for Debian Bullseye, as this would concern anyone upgrading from Buster. - make it so that release notes would be generated from Git, and maybe stored in a debian/release-notes folder, so that it wouldn't generate a diff with the original upstream tag. The drawback would be that, on each upload of a new Debian revision, the debian.tar.xz will contain the release notes, which could be of significant size (especially if they include static objects like CSS, JS, and all what makes a theme). If you have any other suggestion concerning how to handle these release notes, please let me know. Cheers, Thomas Goirand (zigo)