From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Next release from master Date: Wed, 10 Feb 2016 20:08:28 +0200 Message-ID: <83twlga15v.fsf@gnu.org> References: <8qegda3kfg.fsf@fencepost.gnu.org> <83h9i695n5.fsf@gnu.org> <87si118q6e.fsf@gnus.org> <877fid5u3e.fsf@gmx.us> <87bn7pwgaj.fsf@wanadoo.es> <87y4atqq25.fsf@gnus.org> <877fidwaka.fsf@wanadoo.es> <8737t1ckh9.fsf@gmail.com> <56BAAF79.2010109@yandex.ru> <87pow5us9i.fsf@wanadoo.es> <56BAB8F0.1060501@yandex.ru> <87lh6tupox.fsf@wanadoo.es> Reply-To: Eli Zaretskii 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 1455127732 28504 80.91.229.3 (10 Feb 2016 18:08:52 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Wed, 10 Feb 2016 18:08:52 +0000 (UTC) Cc: emacs-devel@gnu.org To: =?utf-8?Q?=C3=93scar?= Fuentes Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Wed Feb 10 19:08:52 2016 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 1aTZC5-0004rZ-Jd for ged-emacs-devel@m.gmane.org; Wed, 10 Feb 2016 19:08:49 +0100 Original-Received: from localhost ([::1]:41658 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aTZC4-0006tO-Uy for ged-emacs-devel@m.gmane.org; Wed, 10 Feb 2016 13:08:48 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:55169) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aTZC0-0006sF-Vb for emacs-devel@gnu.org; Wed, 10 Feb 2016 13:08:46 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aTZBw-0004eY-0N for emacs-devel@gnu.org; Wed, 10 Feb 2016 13:08:44 -0500 Original-Received: from fencepost.gnu.org ([2001:4830:134:3::e]:40475) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aTZBv-0004eQ-TX; Wed, 10 Feb 2016 13:08:39 -0500 Original-Received: from 84.94.185.246.cable.012.net.il ([84.94.185.246]:2825 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_128_CBC_SHA1:128) (Exim 4.82) (envelope-from ) id 1aTZBv-0003CM-68; Wed, 10 Feb 2016 13:08:39 -0500 In-reply-to: <87lh6tupox.fsf@wanadoo.es> (message from =?utf-8?Q?=C3=93sca?= =?utf-8?Q?r?= Fuentes on Wed, 10 Feb 2016 05:58:22 +0100) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2001:4830:134:3::e 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:199708 Archived-At: > From: Óscar Fuentes > Date: Wed, 10 Feb 2016 05:58:22 +0100 > > >> IMO it is very reasonable to require documenting the contributed > >> changes. Without that, code reviews and testing are much harder. > > > > Not if the feature has appropriate docstrings and header commentary. > > I was talking about docstrings and, possibly, NEWS too. No need, these are already included almost always. The problem is the manuals. > > As far as I'm concerned, the manual is a separate universe which > > requires additional knowledge to contribute to. > > This is reasonable, as long as we have people willing to work on it and > that doesn't detract them from other more valuable work they would do > instead. We don't have such people, and probably never will. This is not a for-profit company which can go out and hire such people. Our community is driven by the desire to develop software, so we all quite naturally don't want to "waste time" on documentation. But if we don't work on the documentation, we won't have any, at least not a good one.