From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from lists.gentoo.org (pigeon.gentoo.org [208.92.234.80]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by finch.gentoo.org (Postfix) with ESMTPS id AC1FE1382C5 for ; Tue, 30 Mar 2021 06:55:53 +0000 (UTC) Received: from pigeon.gentoo.org (localhost [127.0.0.1]) by pigeon.gentoo.org (Postfix) with SMTP id 95F7FE086C; Tue, 30 Mar 2021 06:55:51 +0000 (UTC) Received: from smtp.gentoo.org (mail.gentoo.org [IPv6:2001:470:ea4a:1:5054:ff:fec7:86e4]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by pigeon.gentoo.org (Postfix) with ESMTPS id 693B5E085B for ; Tue, 30 Mar 2021 06:55:51 +0000 (UTC) Received: from oystercatcher.gentoo.org (oystercatcher.gentoo.org [148.251.78.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.gentoo.org (Postfix) with ESMTPS id 8EEC733BECB for ; Tue, 30 Mar 2021 06:55:50 +0000 (UTC) Received: from localhost.localdomain (localhost [IPv6:::1]) by oystercatcher.gentoo.org (Postfix) with ESMTP id ED5445B8 for ; Tue, 30 Mar 2021 06:55:48 +0000 (UTC) From: "Ulrich Müller" To: gentoo-commits@lists.gentoo.org Content-Transfer-Encoding: 8bit Content-type: text/plain; charset=UTF-8 Reply-To: gentoo-dev@lists.gentoo.org, "Ulrich Müller" Message-ID: <1617087203.1916f42b99447c45e1f8e920dcdd025715a7c328.ulm@gentoo> Subject: [gentoo-commits] proj/devmanual:master commit in: eclass-writing/ X-VCS-Repository: proj/devmanual X-VCS-Files: eclass-writing/text.xml X-VCS-Directories: eclass-writing/ X-VCS-Committer: ulm X-VCS-Committer-Name: Ulrich Müller X-VCS-Revision: 1916f42b99447c45e1f8e920dcdd025715a7c328 X-VCS-Branch: master Date: Tue, 30 Mar 2021 06:55:48 +0000 (UTC) Precedence: bulk List-Post: List-Help: List-Unsubscribe: List-Subscribe: List-Id: Gentoo Linux mail X-BeenThere: gentoo-commits@lists.gentoo.org X-Auto-Response-Suppress: DR, RN, NRN, OOF, AutoReply X-Archives-Salt: 33ae386e-3920-4ae3-9fe8-546d341dca94 X-Archives-Hash: 6ae25b55e951c331acb830ade1f4fb6f commit: 1916f42b99447c45e1f8e920dcdd025715a7c328 Author: Sam James gentoo org> AuthorDate: Mon Mar 22 05:30:00 2021 +0000 Commit: Ulrich Müller gentoo org> CommitDate: Tue Mar 30 06:53:23 2021 +0000 URL: https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=1916f42b eclass-writing: mention that checking (official) overlays may be useful This is just a politeness/interesting thought which people may want to consider, rather than a hard requirement. For "official" overlays in particular, a Gentoo developer should be able to give the responsible developer(s) a quick ping to ensure they're aware if their overlay seems to be heavily using legacy functionality. Signed-off-by: Sam James gentoo.org> Signed-off-by: Ulrich Müller gentoo.org> eclass-writing/text.xml | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/eclass-writing/text.xml b/eclass-writing/text.xml index 70f9fff..adf3671 100644 --- a/eclass-writing/text.xml +++ b/eclass-writing/text.xml @@ -70,7 +70,10 @@ package, and thus does not typically require changes to be emailed for review.

When removing a function or changing the API of an eclass, make sure that -it doesn't break any ebuilds in the Gentoo repository. +it doesn't break any ebuilds in the Gentoo repository. Optionally, you may wish +to do a survey of some (official) overlays like ::guru, ::musl, or +::science in order to better understand how it is currently used and + where possible avoid breakage by pinging the maintainers directly.