summaryrefslogtreecommitdiff
path: root/CONTRIBUTE
diff options
context:
space:
mode:
authorKarl Fogel <kfogel@red-bean.com>2022-01-10 13:20:29 -0600
committerKarl Fogel <kfogel@red-bean.com>2022-01-10 13:20:29 -0600
commit99f47ede413ea8c04ad1f1ca8f1a678f7942578c (patch)
tree367115bfc1df98a93264d3533210cacfbda5dc78 /CONTRIBUTE
parent97806bc7deeec7ab1458eb5ff689f46ec8e7c652 (diff)
downloademacs-99f47ede413ea8c04ad1f1ca8f1a678f7942578c.tar.gz
Document external maintenance of some packages
Document the fact that some packages in Emacs are externally maintained, and specifically document Org Mode's external maintenance. For more context, see the thread that starts here: https://lists.gnu.org/archive/html/emacs-devel/2021-12/msg00366.html From: Karl Fogel To: Emacs Devel Subject: Improving documentation of Org Mode integration into Emacs. Date: Sat, 04 Dec 2021 15:14:59 -0600 Message-ID: <87zgpgax7w.fsf@red-bean.com>
Diffstat (limited to 'CONTRIBUTE')
-rw-r--r--CONTRIBUTE16
1 files changed, 16 insertions, 0 deletions
diff --git a/CONTRIBUTE b/CONTRIBUTE
index 7c3421ed75a..614afa27db7 100644
--- a/CONTRIBUTE
+++ b/CONTRIBUTE
@@ -366,6 +366,22 @@ reasons. These should be marked by including something like "Do not
merge to master" or anything that matches gitmerge-skip-regexp (see
admin/gitmerge.el) in the commit message.
+** Some packages in Emacs are maintained externally
+
+Sometimes a package that ships as part of GNU Emacs is maintained as a
+separate project, with its own upstream repository, its own maintainer
+group, its own development conventions, etc. The upstream project's
+code is periodically merged into Emacs (exactly when and how such
+merges happen depends on the package).
+
+So when you are making a contribution -- such as fixing a bug or
+proposing an enhancement -- to one of these externally maintained
+packages, you sometimes need to deal with that package at its upstream
+source.
+
+In the section "Externally maintained packages" in "admin/MAINTAINERS"
+we maintain a list of such packages.
+
** GNU ELPA
This repository does not contain the Emacs Lisp package archive