From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms8.migadu.com with LMTPS id cNxAHdgw9WXrrAAAqHPOHw:P1 (envelope-from ) for ; Sat, 16 Mar 2024 06:40:40 +0100 Received: from aspmx1.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0.migadu.com with LMTPS id cNxAHdgw9WXrrAAAqHPOHw (envelope-from ) for ; Sat, 16 Mar 2024 06:40:40 +0100 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=iES8oHkw; dmarc=pass (policy=none) header.from=gmail.com; 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" ARC-Seal: i=1; s=key1; d=yhetil.org; t=1710567640; a=rsa-sha256; cv=none; b=hA3wRPPGUgaqqTH+c8908OFUUqu2xCd2ztvSOEilRwwXXjOs6x6joxkr0mm0300MVcOhbX PTL56Oa49AKjk5ZDGz3MuTcK094DK3MB21kmSi40FkuCmcFJQeS/s1AJ1ajRSHI7QcWQQ9 h++xUQ89KR6AVIq6UvYHmY9dMC211uv/O8FziZvRx8yMdDEMFY3NTCTJ7/DAsunlNqQ1GA 7dtxOOg0WffRymt7qNbNm/fTRCeR+65WCWxig+Hg6STREAcA7kMuzy64KaLHefiRKnlO5m jaeEeIrSDcKJXx7J3MNF0VNAcUlCuwZ+Lvw3wOfSFYGyUNO00had+n/zHo045A== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=gmail.com header.s=20230601 header.b=iES8oHkw; dmarc=pass (policy=none) header.from=gmail.com; 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" ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1710567640; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=+wC0AIDSNbJR7PL6nFvmbipEEyPeGfF6J0Ru7l7AkjE=; b=p5KIWeZd15QGSJ8vSWktnDuXhUr2pa1k+PTH7hjN21J1aeFAFoLQIWPijMCLK9uxPPZA1O ilE3ajCTMO/QrtK25SD2LWlOkkQtWyJHxeQk8YKnpDB4/pDzKHituCM+n53VcF9zM/2OGg V3HM+LmaUqpCrTMp3hzP9DuVbUyztjcPxHl6+Ks1ju6F4eFiiUDytSWK+kGLvwkl4KkxGj x7GmHE+DW6Yu3y0fL4lIDpnChNhv3nL8lK/TDPN0h6Te1b6bW8ez0M1294nX+fLZGapG1P fq6qhhiQ4r6L5tXv1iwoIKMy08rk5mySb2WMiBRX1PVLMFBNgh4OeDpomy5QOA== 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 4B50DD2F8 for ; Sat, 16 Mar 2024 06:40:40 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rlMm5-0007eQ-2K; Sat, 16 Mar 2024 01:40:05 -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 1rlMm0-0007dq-Ew for emacs-orgmode@gnu.org; Sat, 16 Mar 2024 01:40:00 -0400 Received: from mail-ot1-x335.google.com ([2607:f8b0:4864:20::335]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1rlMly-0007fy-My for emacs-orgmode@gnu.org; Sat, 16 Mar 2024 01:40:00 -0400 Received: by mail-ot1-x335.google.com with SMTP id 46e09a7af769-6e675181ceaso1426679a34.2 for ; Fri, 15 Mar 2024 22:39:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1710567597; x=1711172397; darn=gnu.org; h=to:subject:message-id:date:from:mime-version:from:to:cc:subject :date:message-id:reply-to; bh=+wC0AIDSNbJR7PL6nFvmbipEEyPeGfF6J0Ru7l7AkjE=; b=iES8oHkwJ/RN083XAj7YpYB61Xq0bMQHUez9pV6MnZUv534vZiOssUu3K+c0aKN28O bGT3taTlpIbPITxK7lNyppK0ml6s03WxvBQMKJlWBvyZp9n8bWxnpvaJ58U2QBU3tmwM 13PPzg0oEUJfTPXvDgfVbpcaMkHEQhjL91bCABoD1hUYestkyOjRb85JgOlpLOGhlhkp k1cwKVoq46uuU5CVCH+76pKJv2pZu8LQfQ8dTzHl8Ptp0SOmtysQHlYV9v2QMR/I/4gZ MfWZqUSkpMQxxhZKjHbpPp04AFMRDEC6c/BMg8UL6/91K7Mtllwr9TGyrPpdLRrbT5n5 Qr8Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1710567597; x=1711172397; h=to:subject:message-id:date:from:mime-version:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=+wC0AIDSNbJR7PL6nFvmbipEEyPeGfF6J0Ru7l7AkjE=; b=m9jDaq6gySk+zcZFkHiuwN8rcgsTEioLMDRkysnJbnPmyQg54V2YWXX8JKIqR+BdEX x2q5RJN4H4VyV+qqJKKpBihxKAc9hA79/QvnpzyGmznB7Fr8zwrUj39RGjEXd6YoeDX4 9nEc0ARk7HTr6wbiwlpLhxu2jC9VVUoxvuosP01ocgGIy6M3WhCwZvTg4PeGmmSnKUiQ eJQe/xa6M3aREibIsvgCKW7Unqpt3v5EJdECpOwpqlBO0CZ6vvK5dYHbKCoaSnur4Wb2 MN5uAtg58BrXdxGaaiEBEdBc9/LaLKTXq0ysmkunvPrv02S58XyWpDG566ewW3p54eVv 2Mcw== X-Gm-Message-State: AOJu0YyvuTMt4YrKJxwZBgUHZ90paZKlsi7tK5k3d5PRhI/CcweTtiHb IhDGsnMCesA8cyh65YAGfx8u2pTolVaY7cgSZDwdqjzKmoLSKWURiHL5L/jwcruD6kB8hwH473D vIcSCMGM5klJ7TOydrf2Ro78qmak74nwmfRB0hw== X-Google-Smtp-Source: AGHT+IHXGQYLGlZ5FXS7badQ1Gks+TYqHWoujSjcg88CSUhn46Ak4tdWaNFU6hu1xLP17seBtPifROK5FQSwC86lAYk= X-Received: by 2002:a05:6871:3403:b0:222:649a:a932 with SMTP id nh3-20020a056871340300b00222649aa932mr6652611oac.7.1710567597137; Fri, 15 Mar 2024 22:39:57 -0700 (PDT) MIME-Version: 1.0 From: Rudi C Date: Sat, 16 Mar 2024 09:09:21 +0330 Message-ID: Subject: Principled Handling of Breaking Changes To: emacs-orgmode@gnu.org Content-Type: multipart/alternative; boundary="000000000000fde4680613c08d24" Received-SPF: pass client-ip=2607:f8b0:4864:20::335; envelope-from=rudiwillalwaysloveyou@gmail.com; helo=mail-ot1-x335.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 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, FREEMAIL_FROM=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-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-Scanner: mx10.migadu.com X-Migadu-Spam-Score: -7.53 X-Spam-Score: -7.53 X-Migadu-Queue-Id: 4B50DD2F8 X-TUID: tBgfXQ3pqcp9 --000000000000fde4680613c08d24 Content-Type: text/plain; charset="UTF-8" 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. I believe that Org mode would benefit greatly from adopting a more principled approach to backward compatibility. 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. PS: Is there a changelog that ONLY lists breaking changes? There should be one ... PPS: Please use Reply to All when responding to this message. --000000000000fde4680613c08d24 Content-Type: text/html; charset="UTF-8" Content-Transfer-Encoding: quoted-printable
The recent upgrades to Org mode have been a source of grea= t frustration for me. Many of the configurations I had previously set up st= opped working as intended, and it took me several days to properly identify= the issues, debug them, and find suitable workarounds. I believe that Org = mode would benefit greatly from adopting a more principled approach to back= ward compatibility.

To address this concern, I suggest that all brea= king 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-v= ersion` variable, which would be set to nil by default, allowing the packag= e to adapt its behavior as necessary. However, when `org-defaults-use-versi= on` is set to a specific version, all configuration variables should adhere= to the behavior associated with that particular version. Furthermore, I pr= opose that all breaking changes be accompanied by a configuration flag, ena= bling 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 sp= ending hours dealing with frustration and debugging.

PS: Is there a = changelog that ONLY lists breaking changes? There should be one ...
PPS: Please use Reply to All when responding to this message.
--000000000000fde4680613c08d24--