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 10:22:27 +0200 Message-ID: <837g7vdg70.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> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1394871761 15835 80.91.229.3 (15 Mar 2014 08:22:41 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 15 Mar 2014 08:22:41 +0000 (UTC) Cc: stephen@xemacs.org, emacs-devel@gnu.org To: Dmitry Gutov Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Mar 15 09:22:46 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 1WOjrf-0003px-TK for ged-emacs-devel@m.gmane.org; Sat, 15 Mar 2014 09:22:44 +0100 Original-Received: from localhost ([::1]:49174 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WOjrf-0000mr-6v for ged-emacs-devel@m.gmane.org; Sat, 15 Mar 2014 04:22:43 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:39590) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WOjrX-0000ci-VY for emacs-devel@gnu.org; Sat, 15 Mar 2014 04:22:41 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1WOjrS-0001VU-Ja for emacs-devel@gnu.org; Sat, 15 Mar 2014 04:22:35 -0400 Original-Received: from mtaout21.012.net.il ([80.179.55.169]:33523) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1WOjrS-0001VL-Ba; Sat, 15 Mar 2014 04:22:30 -0400 Original-Received: from conversion-daemon.a-mtaout21.012.net.il by a-mtaout21.012.net.il (HyperSendmail v2007.08) id <0N2G00M00XPERH00@a-mtaout21.012.net.il>; Sat, 15 Mar 2014 10:22:28 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by a-mtaout21.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0N2G00MD3XXGPX40@a-mtaout21.012.net.il>; Sat, 15 Mar 2014 10:22:28 +0200 (IST) In-reply-to: <5323B66B.5070405@yandex.ru> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: Solaris 10 X-Received-From: 80.179.55.169 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:170381 Archived-At: > Date: Sat, 15 Mar 2014 04:09:47 +0200 > From: Dmitry Gutov > Cc: emacs-devel@gnu.org > > Updating Texinfo manuals is low-cost? It's a yet another technology a > person will have to learn to contribute, that, in all likelihood, they > won't use anywhere else. Texinfo is almost plain text, the markup you need to learn is quite minimal, and fairly similar semantically to HTML. The markup is also quite a mechanical part of writing the docs, and you will quickly learn to do it correctly given the comments for your first submissions. The main part is writing the text itself, and learning to describe a feature concisely and clearly. That is something you will find useful everywhere, as long as you are involved in writing and maintaining software. Software engineers who can write good docs are rare and therefore quite valued. Take a look at gdb-patches mailing list, where we have people writing docs for every patch, and see for yourself how this works. There are a few of them there for whom writing English is much more difficult than writing C or Python, and yet they still do this.