From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: joaotavora@gmail.com (=?iso-8859-1?Q?Jo=E3o_T=E1vora?=) Newsgroups: gmane.emacs.devel Subject: Re: Results of the "mentoring" experiment Date: Mon, 22 Dec 2014 16:03:24 +0000 Message-ID: References: <20141203142859.24393.98673@vcs.savannah.gnu.org> <20141203193110.GF12748@thyrsus.com> <20141203215426.GA15791@thyrsus.com> <87ppbzplcw.fsf@newcastle.ac.uk> <83iohr48kr.fsf@gnu.org> <83388u4bps.fsf@gnu.org> <83y4qm2uz9.fsf@gnu.org> <83vblq2los.fsf@gnu.org> <87vblpjq24.fsf@uwakimon.sk.tsukuba.ac.jp> <83mw7119yz.fsf@gnu.org> <851tnrpy9j.fsf_-_@stephe-leake.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable X-Trace: ger.gmane.org 1419264235 18620 80.91.229.3 (22 Dec 2014 16:03:55 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 22 Dec 2014 16:03:55 +0000 (UTC) Cc: emacs-devel@gnu.org To: Stephen Leake Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Dec 22 17:03:51 2014 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1Y35SY-00053X-BD for ged-emacs-devel@m.gmane.org; Mon, 22 Dec 2014 17:03:50 +0100 Original-Received: from localhost ([::1]:41057 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y35SX-0000Lq-NC for ged-emacs-devel@m.gmane.org; Mon, 22 Dec 2014 11:03:49 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:42491) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y35SI-0000Hq-6M for emacs-devel@gnu.org; Mon, 22 Dec 2014 11:03:38 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Y35SC-0001G9-KY for emacs-devel@gnu.org; Mon, 22 Dec 2014 11:03:34 -0500 Original-Received: from mail-wg0-x229.google.com ([2a00:1450:400c:c00::229]:64311) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Y35SC-0001G3-Ed for emacs-devel@gnu.org; Mon, 22 Dec 2014 11:03:28 -0500 Original-Received: by mail-wg0-f41.google.com with SMTP id y19so7064063wgg.0 for ; Mon, 22 Dec 2014 08:03:27 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-type:content-transfer-encoding; bh=Zqq1HIAbwZnB9AP3wrOGAWMgf2jnc39ocq2FHYF1+xY=; b=R9aqUBq1kkCMURrxmUsjTnZwlctBA1kquwMyFSD2vSrAVLhTR0MuAlrgv06+1qWQKo w/OyY5w037nnU6G6Fr/8KyDKPHH6cQcFYXdJ4AY6kuRp3vc7tiekeg6SdagfLW1kvA8s IjkQ/w90NmWNp5rrZX+W4RZhBPphM+VlKUGriUUXblNiJid5Qfk3vpeuyl1xHglTEhkJ KRoG5y3lexXc0vTjRHW1frcoqTXFGK0im22V6mhgQ2prvHCu7WjkNE9XjD2cTXOJsSQ2 bLANJQOS+0UDwqV69f9Gj1BGkqFhmXXhT0MjW3dGPX3B80W7omUf5wvjvNti4UksHI2E 1ZtA== X-Received: by 10.180.72.199 with SMTP id f7mr33237157wiv.53.1419264207542; Mon, 22 Dec 2014 08:03:27 -0800 (PST) Original-Received: from GONDOMAR.yourcompany.com (53.236.108.93.rev.vodafone.pt. [93.108.236.53]) by mx.google.com with ESMTPSA id w10sm24210193wje.10.2014.12.22.08.03.26 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Mon, 22 Dec 2014 08:03:26 -0800 (PST) In-Reply-To: <851tnrpy9j.fsf_-_@stephe-leake.org> (Stephen Leake's message of "Mon, 22 Dec 2014 08:14:32 -0600") User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.4 (windows-nt) X-detected-operating-system: by eggs.gnu.org: Error: Malformed IPv6 address (bad octet value). X-Received-From: 2a00:1450:400c:c00::229 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.14 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.org@gnu.org Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:180510 Archived-At: [ sorry for the duplicate reply I sent the previous one from my work address and can't recall it. Please reply to this address. ] Stephen Leake writes: > joaotavora@gmail.com (Jo=E3o T=E1vora) writes: > >> * I found that the information that is sought after in this phase is >> practically all written down and available already, but spread across >> the Elisp manual, wikipedia, the ELPA.git README, git tutorials, >> etc. A nice aggregation of this information would be useful, but this >> was in the original discussion I believe. > > I'm cleaning up this info; can you send me a list? These are the ones I remember from the top of my head: there is obviously more info around. There is also a lot of overlap. Without any mentoring whatsoever, I'd say this is the minimal set for the common case: cleaning up some rotten hack on github and contributing to ELPA.git. Though most of it also applies to contributions to Emacs trunk of course. * https://www.gnu.org/software/emacs/manual/html_node/emacs/Contributing.ht= ml * https://www.gnu.org/software/emacs/manual/html_node/elisp/Tips.html#Tips Particularly the nodes "Coding Conventions" and "Library Headers". I think M-x auto-insert should be mentioned in there somewhere. * etc/CONTRIBUTE or CONTRIBUTE * http://git.savannah.gnu.org/cgit/emacs/elpa.git/tree/README (very useful). * http://www.emacswiki.org/emacs/GitForEmacsDevs (emacswiki is down right now but I think there is also has a quick-start variant): * http://www.emacswiki.org/emacs/ELPA#toc2 * https://savannah.gnu.org/git/?group=3Demacs and its linked http://savannah.gnu.org/maintenance/UsingGit/, which is mostly duplication maybe? I had git credentials already, so I don't know about the patch process if there is one (in the past I just sent them to this list or the bug tracker). Some useful non-GNU stuff * http://lars.ingebrigtsen.no/2014/11/13/welcome-new-emacs-developers/ * https://hpc.uni.lu/blog/2014/understanding-git-subtree/ > Attached is my current patch, splitting CONTRIBUTE into user vs > developer stuff; user stuff is now in the Emacs manual. Sorry, didn't see it and didn't follow that part of the discussion. Were you looking for comments on any specific part of it?=20 Jo=E3o