From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id ME0KNxPp8WYhxAAAe85BDQ:P1 (envelope-from ) for ; Mon, 23 Sep 2024 22:17:56 +0000 Received: from aspmx1.migadu.com ([2001:41d0:303:e16b::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2.migadu.com with LMTPS id ME0KNxPp8WYhxAAAe85BDQ (envelope-from ) for ; Tue, 24 Sep 2024 00:17:55 +0200 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=debbugs.gnu.org header.s=debbugs-gnu-org header.b=rQfxsHhf; dkim=fail ("headers rsa verify failed") header.d=gnu.org header.s=fencepost-gnu-org header.b=pMhbjGcj; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1727129875; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type:resent-cc:resent-from:resent-sender: resent-message-id:in-reply-to:in-reply-to:references:references: list-id:list-help:list-unsubscribe:list-subscribe:list-post: dkim-signature; bh=71/UsfQI4si0a0YrMPM1NLV4u9Z/ZszQSP1PUWJvDZs=; b=WS+N6He+vLoQIqUhH8lcYSI8+h/lo/ne2Fs7bAl1hJUTvLXpzlyO2CCiBJ/lE/63vwKH5z bG76l2w+6Zne31vSjSQxbEPREnffkDgCa4ipUOWPwHi0tSez2ps37CpJd4DKGZo7384fzn L003RZSnX533Kyh0x3sMKnMd8s/UxeawE0JoI27qlOa6/G9Ws8dDDORmCR4kFT3T768/lM Ao14hi/ROkK7ukAntFlDpCbX53a/DNwnfR8b2cOxOSZn1xRdWeGkxA0tdm7uX3LpxOKELa 1pui/PSrzi8mjRmSwMQM878aPCCJ/Y0FzwrcR2tKRyNLrXqMBJzyTiwzxXwUdg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1727129875; a=rsa-sha256; cv=none; b=kYHfPgYAIO7Jx/oDq7CBKr2aCop5m3nKty8nCTWGcyJ2KkhliENFHPFLW8cdO+VKSOo1sf J+HT/Qp0mQHdLW/S4iEq9ZkCs9JR/ga0MONgXjl4DK7gmn9dEZ1OGhBDRGAc6U9TZHbRnX PllrOY1pW7CTMXPVm38QIFfG4YSGTN1uvH2QIumONaB7CPTaod70YNhlJZZf8F2RTd0i98 hhR4ValPeb1xRr8oyrhnmSKYKOdWzKJelJ/mVnm4Kwe7uzUTWFUjWZgfrQx6iRAB10ttBw +/6anfjSTZaxk/VifLWgvjQU5/2qltxlPJT+CdM418esOBlYd5KmUgO+8HTnyg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=debbugs.gnu.org header.s=debbugs-gnu-org header.b=rQfxsHhf; dkim=fail ("headers rsa verify failed") header.d=gnu.org header.s=fencepost-gnu-org header.b=pMhbjGcj; dmarc=pass (policy=none) header.from=gnu.org; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id C34CD9E3F for ; Tue, 24 Sep 2024 00:17:55 +0200 (CEST) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ssrNI-0001LR-22; Mon, 23 Sep 2024 18:17:44 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ssrNF-0001L0-5f for guix-patches@gnu.org; Mon, 23 Sep 2024 18:17:41 -0400 Received: from debbugs.gnu.org ([2001:470:142:5::43]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ssrNC-0001uW-B6 for guix-patches@gnu.org; Mon, 23 Sep 2024 18:17:39 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=debbugs.gnu.org; s=debbugs-gnu-org; h=MIME-Version:Date:References:In-Reply-To:From:To:Subject; bh=71/UsfQI4si0a0YrMPM1NLV4u9Z/ZszQSP1PUWJvDZs=; b=rQfxsHhfBQe8oPxOHoyOKKW8E0oD+UUnWLWXjYTeWx1havbiHbgfeUzyBqMu+TCefMjdtliFaXgYnINZp8qB3XJL4Q8FQcsLBLedKDEq6AuJDrmFHPI+lXkRZlIRJ6lzjtXNmexaLQgkQ+2wzuLxKtg4aipIx8sb+oxxXO4n2qENKhjGNFoMR6ClyQGm58ED3us+gqTV77QKAwjwx2YpWLsCBV9E7qOR2KSDKK6uosGHaCNc4+3yLzI6T+sRGnC+c4kku6pvD7n8HvgmoXNk6OT8IKy1ZeqoxK/opIpx09fA9RCJIPjcTLs2Jix5m0e4bZlXYMxqFueISakZmGkyPQ==; Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1ssrNZ-0001ix-Qy for guix-patches@gnu.org; Mon, 23 Sep 2024 18:18:01 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#72840] [PATCH RFC] DRAFT doc: Add =?UTF-8?Q?=E2=80=9CDeprecation_?= =?UTF-8?Q?Policy=E2=80=9D?= section. Resent-From: Ludovic =?UTF-8?Q?Court=C3=A8s?= Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Mon, 23 Sep 2024 22:18:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 72840 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: To: 72840@debbugs.gnu.org Cc: Konrad Hinsen , "=?UTF-8?Q?No=C3=A9?= Received: via spool by 72840-submit@debbugs.gnu.org id=B72840.17271298496577 (code B ref 72840); Mon, 23 Sep 2024 22:18:01 +0000 Received: (at 72840) by debbugs.gnu.org; 23 Sep 2024 22:17:29 +0000 Received: from localhost ([127.0.0.1]:44850 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ssrN2-0001i1-S3 for submit@debbugs.gnu.org; Mon, 23 Sep 2024 18:17:29 -0400 Received: from eggs.gnu.org ([209.51.188.92]:46170) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1ssrN0-0001hk-Ll for 72840@debbugs.gnu.org; Mon, 23 Sep 2024 18:17:27 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1ssrMX-0001sb-Q3; Mon, 23 Sep 2024 18:16:57 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=MIME-Version:Date:References:In-Reply-To:Subject:To: From; bh=71/UsfQI4si0a0YrMPM1NLV4u9Z/ZszQSP1PUWJvDZs=; b=pMhbjGcjG8e0T+ZeaBxq BwUhZ227IEq9KiqOpLTbBBOPRShTN2yrLt9nAijksBtP9+xKq76VqPyvFx+x/JnlN6EBn116A7Utt MzmRGrfmhC5isfGkTt/DmjmTJ1hnQw0MAWhyTg6oGTT1ynw8Mf7ObiVLi9npmG5oqBTFvcAOEcbun aA7mNjlpkh4LDfOrRXzUpObpF4psgcslids3oD9SxDv1aKScB/mtMnU3YXzzy6SelHlYws1P5cZSd aqDxFEsLqQMzvWfMQhoCuWS1im0QUN1fsk7Ff/luxASefE8kqZCIlKvsAxsoEMm0AcuXUi5IBJoRV y45tBWH4bs+HNg==; From: Ludovic =?UTF-8?Q?Court=C3=A8s?= In-Reply-To: <87zfowk9bh.fsf@gnu.org> ("Ludovic =?UTF-8?Q?Court=C3=A8s?="'s message of "Wed, 28 Aug 2024 16:31:46 +0200") References: <87zfowk9bh.fsf@gnu.org> Date: Tue, 24 Sep 2024 00:16:52 +0200 Message-ID: <87wmj2vwvf.fsf@gnu.org> User-Agent: Gnus/5.13 (Gnus v5.13) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: guix-patches-bounces+larch=yhetil.org@gnu.org X-Migadu-Country: US X-Migadu-Flow: FLOW_IN X-Migadu-Spam-Score: -6.01 X-Spam-Score: -6.01 X-Migadu-Scanner: mx13.migadu.com X-Migadu-Queue-Id: C34CD9E3F X-TUID: eIA8hgq5g/oQ --=-=-= Content-Type: text/plain The v3 -> v4 diff for clarity: --=-=-= Content-Type: text/x-patch Content-Disposition: inline diff --git a/doc/contributing.texi b/doc/contributing.texi index f713765357..d6a684306c 100644 --- a/doc/contributing.texi +++ b/doc/contributing.texi @@ -3062,8 +3062,8 @@ Deprecation Policy @code{home-environment} interfaces together with the service interfaces; @item -development of external tools that use programming interfaces such as -the @code{(guix ...)} modules. +development or use of external tools that use programming interfaces +such as the @code{(guix ...)} modules. @end itemize These use cases form a spectrum with varying degrees of coupling---from @@ -3111,10 +3111,12 @@ Deprecation Policy @anchor{package-removal-policy} @item Package removal Packages whose upstream developers have declared as having reached ``end -of life'' or being unmaintained may be removed. There is no formal -deprecation mechanism for this case, unless a replacement exists, in -which case the @code{deprecated-package} procedure mentioned above can -be used. +of life'' or being unmaintained may be removed; likewise, packages that +have been @b{failing to build for two months or more} may be removed. + +There is no formal deprecation mechanism for this case, unless a +replacement exists, in which case the @code{deprecated-package} +procedure mentioned above can be used. If the package being removed is a ``leaf'' (no other packages depend on it), it may be removed after a @b{one-month review period} of the patch @@ -3133,6 +3135,14 @@ Deprecation Policy is a leaf, its deprecation must be announced as an entry in @code{etc/news.scm}. +@item Package upgrade +In the case of packages with many dependents and/or many users, an +upgrade may be treated like the @emph{removal} of the previous version. + +Examples include major version upgrades of programming language +implementations, as we've seen above with Python, and major upgrades of +``big'' libraries such as Qt or GTK. + @cindex service deprecation @item Services Changes to services for Guix Home and Guix System have a direct impact --=-=-=--