b8c2bac21995747fa0c2f98d7b8e9dd7eaa30741 — Ihor Radchenko 1 year, 9 months ago 366bbdc
org-maintenance.org: Add CUSTOM-ID anchors

* org-maintenance.org (Current maintainers):
(Web presence of maintainers):
(What is the role of a maintainer?):
(What's in a release?):
(We don't follow a release schedule):
(We don't use semantic versioning):
(What's in major, minor and bugfix releases?):
(Where can I track bugs, patches and updates?):
(For the release manager and core maintainers):
(Releasing a new version of Org):
(What goes on the =bugfix= and =main= branches):
(For all releases):
(For bugfix releases):
(Releasing by adding a new tag):
(Preparing and annoncing the release):
(Synchronization Org and upstream Emacs):
(Backporting changes from upstream Emacs):
(Updating the Org version in upstream Emacs):
(Where do files go):
(Update  =emacs/etc/NEWS=):
(Updating the list of hooks/commands/options on Worg):
(Copyright assignments):
1 files changed, 70 insertions(+), 1 deletions(-)

M org-maintenance.org
M org-maintenance.org => org-maintenance.org +70 -1
@@ 16,6 16,9 @@ This document describes the tasks the Org-mode maintainers have to do
and how they are performed.

* Current maintainers
:CUSTOM_ID: current-maintainers

Carsten Dominik created Org and is still active on the list.

@@ 42,6 45,9 @@ Some files have a dedicated maintainer: just grep =;; Maintainer= in
Org's repository to find them.

* Web presence of maintainers
:CUSTOM_ID: web-presense-maintainers

The recommended way to contact the Org maintainers is by sharing your
question, patch or bug report on [[https://orgmode.org/worg/org-mailing-list.html][the mailing list]].

@@ 59,6 65,9 @@ a table with the accounts of the current maintainers:
| Timothy |          |               |          |        |

* What is the role of a maintainer?
:CUSTOM_ID: maintainer-role

If you speak [[https://learnxinyminutes.com/docs/elisp/][Emacs lisp]] and are a regular user of an Org file, please
consider becoming a maintainer for it: you can simply ask on the list.

@@ 80,14 89,23 @@ with a change, he can ask a maintainer to revert it.
See also this steps for [[https://orgmode.org/worg/org-contribute.html#devs][your first commit as a]] maintainer.

* What's in a release?
:CUSTOM_ID: release

** We don't follow a release schedule
:CUSTOM_ID: release-schedule

Org development is the work of volunteers and we cannot promise to
follow a release schedule.  You can support the work of contributors
through the [[https://liberapay.com/org-mode/][Org Mode Liberapay team]].

** We don't use semantic versioning
:CUSTOM_ID: semantic-versioning

We use the same numbering convention than semantic versioning, but we
don't follow the rules of SemVer, as expressed in [[https://semver.org][semver.org]].

@@ 102,6 120,9 @@ upgrading!  All other users are welcome to read them too."
This de facto convention has been made explicit after =9.4=.

** What's in major, minor and bugfix releases?
:CUSTOM_ID: release-types

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

@@ 145,6 166,9 @@ Before any release, maintainers test the release against the last
three major releases of Emacs.

* Where can I track bugs, patches and updates?
:CUSTOM_ID: bug-tracker

On [[https://updates.orgmode.org][updates.orgmode.org]], which uses [[https://github.com/bzg/woof][Woof!]] to advertize important
changes (upcoming breaking changes, new releases), confirmed bugs,

@@ 167,8 191,17 @@ contribution.
You can check the [[https://github.com/bzg/woof/blob/master/resources/md/howto.org][Woof! howto]] if you want to explore the details.

* For the release manager and core maintainers
:CUSTOM_ID: release-checklist
** Releasing a new version of Org
:CUSTOM_ID: new-release-checklist
*** What goes on the =bugfix= and =main= branches
:CUSTOM_ID: branches

The [[https://git.savannah.gnu.org/cgit/emacs/org-mode.git/][git repository]] has two branches: =main= for current development and
=bugfix= for bug fixes against latest major or minor release.

@@ 182,6 215,9 @@ release suffixed by =-pre=: e.g. =9.6-pre=.  The =;; Version:= header of the
==bugfix= branch is set to the last stable release, e.g. =9.5.5=.

*** For all releases
:CUSTOM_ID: merging

The =bugfix= branch should always be merged into =main.=

@@ 191,16 227,25 @@ Always remember to set the =;; Version: [...]= metadata in =org.el=

*** For bugfix releases
:CUSTOM_ID: bugfix-releases

When doing a bugfix release (and only then), you shoud *NOT* merge the
=main= branch into the =bugfix= branch.

*** For minor and major releases
:CUSTOM_ID: minor-major-releases

When doing a minor or major release, the =main= branch should be merged
into the =bugfix= branch.

*** Releasing by adding a new tag
:CUSTOM_ID: release-tags

When doing a major and a minor release, after all necessary merging is
done, you need to tag the =bugfix= branch for the release with:

@@ 218,6 263,9 @@ We also encourage you to sign the release tags like this:
Pushing the new tag will trigger the release on GNU ELPA.

*** Preparing and annoncing the release
:CUSTOM_ID: release-announcement

Bugfix releases don't require specific annoucements.

@@ 232,10 280,16 @@ copying the first section of =etc/ORG-NEWS= in the =Changes.org= page of
the [[https://git.sr.ht/~bzg/orgweb][orgweb]] repository.

** Synchronization Org and upstream Emacs
:CUSTOM_ID: emacs-sync

Below it is described how Org is kept in sync with the upstream Emacs.

*** Backporting changes from upstream Emacs
:CUSTOM_ID: backporting-emacs

Sometimes Emacs maintainers make changes to Org files.  The process of
propagating the changes back to the Org repository is called

@@ 258,6 312,9 @@ There is also a [[http://git.savannah.gnu.org/cgit/emacs.git/atom/lisp/org/][fee
folder in the Emacs repository.

*** Updating the Org version in upstream Emacs
:CUSTOM_ID: org-version-emacs

New releases of Org should be added to the [[https://git.savannah.gnu.org/cgit/emacs.git][Emacs repository]].

@@ 276,7 333,10 @@ has been tested.
Please see [[http://git.savannah.gnu.org/cgit/emacs.git/tree/CONTRIBUTE][CONTRIBUTE]] in the Emacs repository for guidelines on
contributing to the Emacs repository.

**** Where to files go
**** Where do files go
:CUSTOM_ID: emacs-folders

The following list shows where files in Org repository are copied to
in the Emacs repository, folder by folder.

@@ 310,11 370,17 @@ in the Emacs repository, folder by folder.
***** TODO =org-mode/testing=

**** Update  =emacs/etc/NEWS=
:CUSTOM_ID: emacs-news

Whenever a new (major) version of Org is synchronized to the Emacs
repository, it should be mentioned in the NEWS file.

** Updating the list of hooks/commands/options on Worg
:CUSTOM_ID: release-auto-documentation

Load the =mk/eldo.el= file then =M-x eldo-make-doc RET=.

@@ 326,6 392,9 @@ Import this file into =worg/doc.org=, leaving the header untouched
Then commit and push the change on the =worg.git= repository.

** Copyright assignments
:CUSTOM_ID: copyright

The maintainers needs to keep track of copyright assignments.  Even
better, find a volunteer to do this.