From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: =?UTF-8?B?UHJ6ZW15c8WCYXcgV29qbm93c2tp?= Newsgroups: gmane.emacs.devel Subject: Re: More metaproblem Date: Mon, 08 Dec 2014 22:23:10 +0100 Message-ID: <548616BE.3050701@cumego.com> References: <20141203142859.24393.98673@vcs.savannah.gnu.org> <20141203192721.GE12748@thyrsus.com> <547F6774.50700@cs.ucla.edu> <838uio5vjw.fsf@gnu.org> <20141203211447.GB15111@thyrsus.com> <871toge5zw.fsf@floss.red-bean.com> <83388v6hsq.fsf@gnu.org> <87egsftgd5.fsf@ktab.red-bean.com> <83egsf3yci.fsf@gnu.org> <87iohq6nvn.fsf@ktab.red-bean.com> <85bnnhkuep.fsf@stephe-leake.org> <857fy4ipsd.fsf@stephe-leake.org> <85y4qjdsg0.fsf@stephe-leake.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: ger.gmane.org 1418073824 1292 80.91.229.3 (8 Dec 2014 21:23:44 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Mon, 8 Dec 2014 21:23:44 +0000 (UTC) To: emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Mon Dec 08 22:23:38 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 1Xy5mL-0001Uf-9T for ged-emacs-devel@m.gmane.org; Mon, 08 Dec 2014 22:23:37 +0100 Original-Received: from localhost ([::1]:36226 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xy5mK-0007tD-P3 for ged-emacs-devel@m.gmane.org; Mon, 08 Dec 2014 16:23:36 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:41218) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xy5mC-0007oN-Me for emacs-devel@gnu.org; Mon, 08 Dec 2014 16:23:34 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xy5m2-0001lO-E5 for emacs-devel@gnu.org; Mon, 08 Dec 2014 16:23:28 -0500 Original-Received: from smtp11.iq.pl ([86.111.242.220]:41214) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xy5m2-0001jw-5B for emacs-devel@gnu.org; Mon, 08 Dec 2014 16:23:18 -0500 Original-Received: (qmail 10494 invoked from network); 8 Dec 2014 21:23:11 -0000 Original-Received: from unknown (HELO [192.168.1.106]) (esperanto@cumego.com@[159.205.31.128]) (envelope-sender ) by smtp19.iq.pl with AES128-SHA encrypted SMTP for ; 8 Dec 2014 21:23:11 -0000 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:31.0) Gecko/20100101 Thunderbird/31.3.0 In-Reply-To: <85y4qjdsg0.fsf@stephe-leake.org> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 86.111.242.220 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:179477 Archived-At: -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Hi. IMHO if you want to know what should be in CONTRIBUTE and/or Info doc just look at some of successful Github projects. A common thing is to have description of: 1. How to build a project from source (http://lars.ingebrigtsen.no/2014/11/13/welcome-new-emacs-developers/ is a good start). 2. How to run (automated) tests - IMHO a must if a project want to be perceived as modern by young developers. Without automated tests young devs will think that project stuck in 80's. Moreover, automated tests enable refactoring, which is standard now. Writing tests is very good starting point for new devs, because one can learn about the system and make it more resistant to unintended changes at the same time. 3. What are coding conventions, if are not language-wide (K&R for C?, what about elisp?). How about clean code (http://www.amazon.com/Clean-Code-Handbook-Software-Craftsmanship/dp/0132350882)? Can split a long function into couple cohesive ones or you don't care about readability? 4. GH has fantastic pull requests that make contribution easier to do and less public, which is encouraging. Here, sending patches to the list, is technically harder (less of a problem) and discouraging (send a patch and watch 100 emails humiliating you :-) ). If you are an agile developer, then just take it as a feedback. If you are not, the please ignore. Hope it helps. Cheers, Przemyslaw W dniu 07.12.2014 o 23:07, Stephen Leake pisze: [...] -----BEGIN PGP SIGNATURE----- Version: GnuPG v1 iQIcBAEBAgAGBQJUhha2AAoJEC3CE3LuBFUoNF0P+wZdvpxXkdLeFSqBPIWFbZkR QobU1T805/cFoyOa9kFb43zL860QeYfboSVumdqhhDqbB4KftYyf36jajksvZ71F yp2H+p+IBgy9xw+10pT6+X76GIe1h9ckvCTGKPMPW1IbSBpZnY6aPr4TMK3wgUh0 YdkzzIcC4btijaMhr9+LWfZWgWdK2ZKKMvJuI7r82ITDwugRH6Ls5zi/fLGKrIp2 jUXfuilCRd799yvDfTPotsX9rrdIl+c8rYkAUpeeVpnnvtTKUoyDk4UQhapC4TN2 H0B9bxt1w4gRGDQrmwz7GW+nJrytyANZSsirwFCOlHw1bpym8ckqz1+BEgCHJOjp hnfItQXGkz+Vz9oU3HZEwdPc2dYqiU1ZZwexDLIRszJ74joyj4aEuT5y5eHY26Hk nkUzSv8srneTfPJ75gIzPR6hl2H82fdCYXGRMAizfirCPsazhXc9OK5+1ljW8JnQ c1lDK0gJY4cE2H9hd0gUIFIYOwZ3u/m7Sc8UQLLaDgYqR9+1S5rhQ7g/4axh5h9h E5BpkvUlFqfG/+8JxKTpkYDaS9Ik8VVWMVGw43OF8J+LahU8PEzL2dMrwZLC+ItD 3tJW/QVUmU4OIq6uzy51mAhi+9cnBjPFTydhzoqZirSQbnjqvFb/FOrNHaCZTh6r AmVQ9TYlhqx+5SNQDyBY =KnDG -----END PGP SIGNATURE-----