From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>
Received: from mp0.migadu.com ([2001:41d0:403:58f0::])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	by ms8.migadu.com with LMTPS
	id iHcAGf5x9WVmMwEAqHPOHw:P1
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	for <larch@yhetil.org>; Sat, 16 Mar 2024 11:18:38 +0100
Received: from aspmx1.migadu.com ([2001:41d0:403:58f0::])
	(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits))
	by mp0.migadu.com with LMTPS
	id iHcAGf5x9WVmMwEAqHPOHw
	(envelope-from <emacs-orgmode-bounces+larch=yhetil.org@gnu.org>)
	for <larch@yhetil.org>; Sat, 16 Mar 2024 11:18:38 +0100
X-Envelope-To: larch@yhetil.org
Authentication-Results: aspmx1.migadu.com;
	dkim=pass header.d=posteo.net header.s=2017 header.b=FIQeS1+X;
	spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org";
	dmarc=pass (policy=none) header.from=posteo.net
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org;
	s=key1; t=1710584318;
	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:in-reply-to:in-reply-to:
	 references:references:list-id:list-help:list-unsubscribe:
	 list-subscribe:list-post:dkim-signature;
	bh=8D6Hfxks+VOBk1f0JMHisP4g3vqzM95wLM7X7cBegu4=;
	b=GX0rvY5OHW03TKGYtuIAa+OWwqBe1/rcw6qiQaGWj6GZ5XEBWy9z7Y2TVhn3EIsH5ZM6KQ
	5xGYLB+5K/NuZCGLHohVdWtDSIiHn9nFHRBrLOBsPiSrsPOj42spd8ZVVXrkEreRoIthds
	D83xigZkFndH/NC88EYxHI+Umg/raCxVhkse3FSV2f3VHTruJwcuNXFBh6FGbapMXueWJq
	9YSSjYcf2u/DQ2BuRGSOIi23tZX1Xpi3EvWSyUH5+P8j/fqchWBaSk1hOCrGpy7iSOxzRu
	3AoRJgiYUCzI7i398UcTQhnGTBT+SPa47WoSfx1wgexEynVjunRTz8IVHvDM0A==
ARC-Seal: i=1; s=key1; d=yhetil.org; t=1710584318; a=rsa-sha256; cv=none;
	b=cSEvzLXUZlp8hla6K8YAm6OukJW3YSWfTXF80AC5Q9vtXSFPIUCM3C0wlCf0fCSdfSENtW
	EM6FAmrA5dagDzuD1Uoef3Qvpuka96MOto4YUv3Pgm711FmJg7ZiKwfuRCSjnvRiIaEGQf
	Giov3VDtQhTdCDco316Zj6LKDFB6GGMh7Dsp7cQZ5Fhppz7QlBY3i4mODlUE0OH6jEYQJO
	48fpxNBgGzuMUEIqDpV7A0BwkxrxLcCFLNBGh6wIGDazgPfdu7CujznVMAafEOLJqRK1aP
	ZTLoDHJuCW5LEf7WZCeijZ9scCkyGxVrp39UO2Rnc4lBRBuyl1Ji+/G2NVFr0g==
ARC-Authentication-Results: i=1;
	aspmx1.migadu.com;
	dkim=pass header.d=posteo.net header.s=2017 header.b=FIQeS1+X;
	spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org";
	dmarc=pass (policy=none) header.from=posteo.net
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 43CD06FB85
	for <larch@yhetil.org>; Sat, 16 Mar 2024 11:18:38 +0100 (CET)
Received: from localhost ([::1] helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <emacs-orgmode-bounces@gnu.org>)
	id 1rlR7L-0006ev-0D; Sat, 16 Mar 2024 06:18:19 -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 <yantar92@posteo.net>)
 id 1rlR7J-0006eW-Ku
 for emacs-orgmode@gnu.org; Sat, 16 Mar 2024 06:18:17 -0400
Received: from mout01.posteo.de ([185.67.36.65])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <yantar92@posteo.net>)
 id 1rlR7H-0007rr-5H
 for emacs-orgmode@gnu.org; Sat, 16 Mar 2024 06:18:17 -0400
Received: from submission (posteo.de [185.67.36.169]) 
 by mout01.posteo.de (Postfix) with ESMTPS id 06BC6240027
 for <emacs-orgmode@gnu.org>; Sat, 16 Mar 2024 11:18:12 +0100 (CET)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=posteo.net; s=2017;
 t=1710584293; bh=FWPSiot1NAglodkB5lFdRJ+scCVNVRigpFeF6TCmDMQ=;
 h=From:To:Cc:Subject:Date:Message-ID:MIME-Version:Content-Type:
 From;
 b=FIQeS1+XoF0Dbt+AIYn/MD47fPmx7xDNJi3Cg/bCa/vubV20qhZ+31jXs2NNlwxCc
 slIQIVJ2DSjzZLBDEScyKHRJLw+VgZAOQOPvTVA/rBk+jchLJs45ScQQtc1jxFAgeH
 kBdgfl9XrYrc8IoAWH0iWdezG5H8oqw0zFgow7t/BbgRdmuNJneiFoRj3/Pkl1TszM
 ZZk8dTEQYwm500CFBpNhrfHGJ2tsy2y8EiHVK4EGxIoM545mpg1gzWANM+Kll4iAhC
 Jv4G6g5AwCNu3NsGzMhJs+ZDhZjVTLpIVEjCHT8uVAaLPnrXCEBmolR2aj1EPuoEUj
 z8RTnwPh1b+vA==
Received: from customer (localhost [127.0.0.1])
 by submission (posteo.de) with ESMTPSA id 4TxcWm24bcz6twX;
 Sat, 16 Mar 2024 11:18:12 +0100 (CET)
From: Ihor Radchenko <yantar92@posteo.net>
To: Rudi C <rudiwillalwaysloveyou@gmail.com>
Cc: emacs-orgmode@gnu.org
Subject: Re: Principled Handling of Breaking Changes
In-Reply-To: <CAE9z9A2kdGXP4nug0Cje2Ycay3B9Dr=ii5VVOvczYSQtLVN7Fg@mail.gmail.com>
References: <CAE9z9A2kdGXP4nug0Cje2Ycay3B9Dr=ii5VVOvczYSQtLVN7Fg@mail.gmail.com>
Date: Sat, 16 Mar 2024 10:18:08 +0000
Message-ID: <87plvuiiov.fsf@localhost>
MIME-Version: 1.0
Content-Type: text/plain
Received-SPF: pass client-ip=185.67.36.65; envelope-from=yantar92@posteo.net;
 helo=mout01.posteo.de
X-Spam_score_int: -43
X-Spam_score: -4.4
X-Spam_bar: ----
X-Spam_report: (-4.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1,
 DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1,
 RCVD_IN_DNSWL_MED=-2.3, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001,
 SPF_HELO_NONE=0.001, SPF_PASS=-0.001,
 T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no
X-Spam_action: no action
X-BeenThere: emacs-orgmode@gnu.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/emacs-orgmode>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
 <mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org
Sender: emacs-orgmode-bounces+larch=yhetil.org@gnu.org
X-Migadu-Flow: FLOW_IN
X-Migadu-Country: US
X-Migadu-Spam-Score: -8.41
X-Spam-Score: -8.41
X-Migadu-Queue-Id: 43CD06FB85
X-Migadu-Scanner: mx11.migadu.com
X-TUID: b38atHtq8vuq

Rudi C <rudiwillalwaysloveyou@gmail.com> writes:

> The recent upgrades to Org mode have been a source of great frustration for
> me. Many of the configurations I had previously set up stopped working as
> intended, and it took me several days to properly identify the issues,
> debug them, and find suitable workarounds.

Apart from the issue with tab-width you reported, what other breaking
changes caused problems for you?

> To address this concern, I suggest that all breaking changes in Org mode
> follow a versioning scheme similar to Perl's `use v5.34.0;`. This could be
> achieved by introducing an `org-defaults-use-version` variable, which would
> be set to nil by default, allowing the package to adapt its behavior as
> necessary. However, when `org-defaults-use-version` is set to a specific
> version, all configuration variables should adhere to the behavior
> associated with that particular version. Furthermore, I propose that all
> breaking changes be accompanied by a configuration flag, enabling users to
> disable the change if they so desire. By implementing these suggestions,
> users would be able to upgrade Org mode without the fear of spending hours
> dealing with frustration and debugging.

This might be a good idea, but not necessary for Org mode in particular.
Rather for Emacs in general. Would you be interested to post this
suggestion on emacs-devel list?

> PS: Is there a changelog that ONLY lists breaking changes? There should be
> one ...

The very first section in https://orgmode.org/Changes.html lists
breaking and important changes. Users are free to limit reading the
changelog to this first section. It is not clear for me why we need a
separate page. 

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>