~bzg/worg

4aa899094b1a98a9fb4afc61ef537dd8c45400ce — Bastien a month ago 4229dfa
org-maintenance.org: More explanations about Emacs compatibility
1 files changed, 23 insertions(+), 17 deletions(-)

M org-maintenance.org
M org-maintenance.org => org-maintenance.org +23 -17
@@ 63,6 63,28 @@ can ask a maintainer to revert it.
Org development is the work of volunteers and we cannot promise to
follow a release schedule.

** Org releases are compatible with the latest three major Emacs releases
:PROPERTIES:
:CUSTOM_ID: emacs-compatibility
:END:

We aim at keeping the latest stable version of Org compatible with the
*last three major releases of Emacs*.

For example, if the latest release of Emacs is 28.x, you can expect
the latest release of Org to be compatible with Emacs 28.x, 27.x and
26.x, but not with Emacs 25.x.

It does not mean that Org will not be usable, at least partially, with
older Emacsen: but maintainers are not bound to fix bugs reported on
them.

Org versions that are not yet released (from the main or bugfix
branch) don't come with any promise regarding compatibility.

Before any release, maintainers test the release against the last
three major releases of Emacs.

** We don't use semantic versioning

We use the same numbering convention than semantic versioning, but we


@@ 77,7 99,7 @@ upgrading!  All other users are welcome to read them too."

This de facto convention has been made explicit after =9.4=.

** Major, minor and bugfix releases
** What's in major, minor and bugfix releases?

- Major release :: The release number for a major release look like
  this: =10=.  Major releases are made whenever Org is in a state where


@@ 96,22 118,6 @@ This de facto convention has been made explicit after =9.4=.
  afford not to fix in a minor release.  Bugfixes releases don't have
  release notes.

** Compatibility with Emacs versions
:PROPERTIES:
:CUSTOM_ID: emacs-compatibility
:END:

We aim at keeping the latest stable version of Org compatible with the
*last three major releases of Emacs*.

For example, if the latest release of Emacs is 28.x, then you can
assume that the latest release of Org is compatible with Emacs 28.x,
27.x and 26.x, but not with Emacs 25.x.

It does not mean that Org will not be usable, at least partially, with
older Emacsen: but maintainers are not bound to fix bugs reported on
them.

** Conventions before and after Org 9.5

Note that before =Org 9.5=, versions like =9.3=, =9.4=, etc. were really