From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: On Contributing To Emacs Date: Wed, 29 Dec 2021 15:13:29 +0200 Message-ID: <834k6rlfk6.fsf@gnu.org> References: <87tuesndye.fsf@localhost> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="36835"; mail-complaints-to="usenet@ciao.gmane.io" Cc: yantar92@gmail.com, emacs-devel@gnu.org To: Stefan Kangas Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Dec 29 14:14:58 2021 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1n2YnC-0009LN-JK for ged-emacs-devel@m.gmane-mx.org; Wed, 29 Dec 2021 14:14:58 +0100 Original-Received: from localhost ([::1]:55034 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1n2YnA-0004p3-OL for ged-emacs-devel@m.gmane-mx.org; Wed, 29 Dec 2021 08:14:56 -0500 Original-Received: from eggs.gnu.org ([209.51.188.92]:49136) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n2Ylj-00046u-OE for emacs-devel@gnu.org; Wed, 29 Dec 2021 08:13:27 -0500 Original-Received: from [2001:470:142:3::e] (port=38132 helo=fencepost.gnu.org) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n2Ylj-0003J1-Du; Wed, 29 Dec 2021 08:13:27 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=iX2I5m/nAOjAO80sBU4lfssWPi5VuSLhOiAaxJvo7kE=; b=AHovoYfcE7aH rhNrHdcsikrrfGUdU6jtYZMD8mAF5dX5qx14BHJwhOghETNE2QlazBOX4GxPSfcprMA/SIsXBOsgS S6oPsOx7jrrkiAQh9u7lXPeDBx80p6yknkXnhb1YufRgbipaFUgY0/cY1xBbYUTT895yxY5npKTwl 94DaSXLZ6ssrTSDT5yWXNi6Sr2L11UBxs9nC+nihgXmDyTgeL4xNfAjN3SzDlEgsEgie89DiZvjP2 euqBGjMuSXMZTcV0+9UB2P7yHWr1GhK4nz/R0BcCjkOwLa2csTBhlIvHlbQB3o+yHgak/XCGMcHlR SVElgcUK/SfEY/8Dlwys9Q==; Original-Received: from [87.69.77.57] (port=3559 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1n2Ylj-0001E9-6r; Wed, 29 Dec 2021 08:13:27 -0500 In-Reply-To: (message from Stefan Kangas on Wed, 29 Dec 2021 01:33:57 -0800) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:283556 Archived-At: > From: Stefan Kangas > Date: Wed, 29 Dec 2021 01:33:57 -0800 > Cc: emacs-devel@gnu.org > > >> Our core packages can be released straight from master to GNU ELPA > >> within 24 hours. All you need to do, once it is set up (which in itself > >> is trivial), is to bump the version header. This is already the case > >> with for example flymake.el and python.el. > > > > Could this information be added to "GNU ELPA" section of the CONTRIBUTE > > file? The current contents of the section is rather confusing: > > > > "This repository does not contain the Emacs Lisp package archive > > (elpa.gnu.org). See admin/notes/elpa for how to access the GNU ELPA > > repository." > > How is this? > > diff --git a/CONTRIBUTE b/CONTRIBUTE > index 7c3421ed75..f2d161e808 100644 > --- a/CONTRIBUTE > +++ b/CONTRIBUTE > @@ -372,6 +372,14 @@ This repository does not contain the Emacs Lisp > package archive > (elpa.gnu.org). See admin/notes/elpa for how to access the GNU ELPA > repository. > > +Some packages are so-called "core" packages. The GNU ELPA scripts > +will pick them up from the Emacs master branch and release them as > +packages periodically; a new version is packaged when their "Version" > +comment header is updated. Normally a new package is released within > +24 hours after bumping the version on the Emacs master branch. An > +examples is lisp/progmodes/python.el, which is released as the "python" > +package at: https://elpa.gnu.org/packages/python.html > + The file CONTRIBUTE is supposed to help contributors, actual and potential, to understand how to participate in the Emacs project. That's what it says at its beginning: * How developers contribute to GNU Emacs Here is how software developers can contribute to Emacs. I don't see how the above text fits that purpose. The ELPA section is there, and says what it says, so that people wouldn't assume that this file also covers ELPA: ** GNU ELPA This repository does not contain the Emacs Lisp package archive (elpa.gnu.org). See admin/notes/elpa for how to access the GNU ELPA repository. It is okay to add text about ELPA if it includes some practically useful information about something related to ELPA that is relevant to contributing to the Emacs project. But the proposed text doesn't have any such practical information, it just expands on what ELPA provides. (It also talks about "core" packages without explaining what that means or how to tell whether a given package is "core".) So if we want to add something like that to CONTRIBUTE, we need to rephrase it so that it fits the purpose of this file. I cannot yet see how to rephrase that, but that's probably because I don't understand Ihor's request in the first place: why would it be useful to have this information in CONTRIBUTE, which is a large file most of which is utterly irrelevant to ELPA? Thanks.