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: Trunk still not open Date: Sat, 15 Mar 2014 13:18:52 +0200 Message-ID: <83zjkrbtgj.fsf@gnu.org> References: <6xwqfxhl88.fsf@fencepost.gnu.org> <83txb1mcsy.fsf@gnu.org> <87siqlku0i.fsf@uwakimon.sk.tsukuba.ac.jp> <87wqfxari2.fsf@yandex.ru> <87ha70kyy3.fsf@uwakimon.sk.tsukuba.ac.jp> <5323B66B.5070405@yandex.ru> <837g7vdg70.fsf@gnu.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1394882342 17329 80.91.229.3 (15 Mar 2014 11:19:02 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 15 Mar 2014 11:19:02 +0000 (UTC) Cc: stephen@xemacs.org, emacs-devel@gnu.org, dgutov@yandex.ru To: Juanma Barranquero Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Mar 15 12:19:10 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 1WOmcP-0005wD-S8 for ged-emacs-devel@m.gmane.org; Sat, 15 Mar 2014 12:19:09 +0100 Original-Received: from localhost ([::1]:49629 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WOmcP-0000Ai-EF for ged-emacs-devel@m.gmane.org; Sat, 15 Mar 2014 07:19:09 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:37208) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WOmcH-0000AZ-Tz for emacs-devel@gnu.org; Sat, 15 Mar 2014 07:19:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WOmcC-00051P-U5 for emacs-devel@gnu.org; Sat, 15 Mar 2014 07:19:01 -0400 Original-Received: from mtaout22.012.net.il ([80.179.55.172]:49207) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WOmcC-0004zs-M5 for emacs-devel@gnu.org; Sat, 15 Mar 2014 07:18:56 -0400 Original-Received: from conversion-daemon.a-mtaout22.012.net.il by a-mtaout22.012.net.il (HyperSendmail v2007.08) id <0N2H00100612PA00@a-mtaout22.012.net.il> for emacs-devel@gnu.org; Sat, 15 Mar 2014 13:18:54 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout22.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0N2H0012Q63HDY70@a-mtaout22.012.net.il>; Sat, 15 Mar 2014 13:18:54 +0200 (IST) In-reply-to: X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: Solaris 10 X-Received-From: 80.179.55.172 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:170391 Archived-At: > From: Juanma Barranquero > Date: Sat, 15 Mar 2014 11:52:44 +0100 > Cc: Dmitry Gutov , Stephen Turnbull , > Emacs developers > > On Sat, Mar 15, 2014 at 9:22 AM, Eli Zaretskii wrote: > > > Software engineers who can write good docs are rare and > > therefore quite valued. > > That's why I'm unimpressed by the idea of forcing changes to include > docs. Not everyone is able to write Emacs-manual-quality docs, and > specially, not everyone is so fluent in English to write good English > docs; some of us struggle with it. I understand that, believe me. I mentioned gdb-patches; you can see there that most of the burden of helping those whose English is much worse than yours is on yours truly's shoulders. So I know something about that, having done that for several years now, and after all that I still think this is our best alternative to having manuals that are in sync with the sources at any given time. In particular, once a GDB release is decided on, the release-blocking issues never include the docs, and in general a release tarball is out the door in no time, something we can only envy in Emacs. Of course, if this is decided, we will have to provide the same kind of help you see on gdb-patches for those whose initial attempts at providing documentation will need that.