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: On being web-friendly and why info must die Date: Fri, 05 Dec 2014 22:23:01 +0200 Message-ID: <83egsd3kyi.fsf@gnu.org> References: <20141205123549.GA29331@thyrsus.com> <2815659.zRQ0WWWeRr@descartes> <20141205175810.GD3120@thyrsus.com> <87lhmlncb1.fsf@earlgrey.lan> <20141205193643.GB5067@thyrsus.com> Reply-To: Eli Zaretskii 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 1417810984 4230 80.91.229.3 (5 Dec 2014 20:23:04 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 5 Dec 2014 20:23:04 +0000 (UTC) Cc: cwebber@dustycloud.org, ruediger@c-plusplus.de, emacs-devel@gnu.org To: esr@thyrsus.com Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Dec 05 21:22:58 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 1XwzOz-000297-VQ for ged-emacs-devel@m.gmane.org; Fri, 05 Dec 2014 21:22:58 +0100 Original-Received: from localhost ([::1]:52358 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XwzOz-00037n-J6 for ged-emacs-devel@m.gmane.org; Fri, 05 Dec 2014 15:22:57 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:59747) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XwzOs-00037H-A0 for emacs-devel@gnu.org; Fri, 05 Dec 2014 15:22:55 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XwzOn-0003hU-AM for emacs-devel@gnu.org; Fri, 05 Dec 2014 15:22:50 -0500 Original-Received: from mtaout25.012.net.il ([80.179.55.181]:56120) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XwzOn-0003h2-3S for emacs-devel@gnu.org; Fri, 05 Dec 2014 15:22:45 -0500 Original-Received: from conversion-daemon.mtaout25.012.net.il by mtaout25.012.net.il (HyperSendmail v2007.08) id <0NG400I00L8DGM00@mtaout25.012.net.il> for emacs-devel@gnu.org; Fri, 05 Dec 2014 22:18:26 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout25.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NG400HIELQQEW20@mtaout25.012.net.il>; Fri, 05 Dec 2014 22:18:26 +0200 (IST) In-reply-to: <20141205193643.GB5067@thyrsus.com> X-012-Sender: halo1@inter.net.il X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x X-Received-From: 80.179.55.181 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:179006 Archived-At: > Date: Fri, 5 Dec 2014 14:36:43 -0500 > From: "Eric S. Raymond" > Cc: R=FCdiger Sonderfeld , > =09emacs-devel@gnu.org >=20 > > But a lot of this is cosmetic. We could improve Texinfo to look = much > > better probably (and that would positively affect a lot of existi= ng GNU > > projects). >=20 > But it would still be Texinfo, still be an essentially pointless > barrier to learning how to contribute. Nonsense. What evidence do you have to back that up? Here's the evidence I have: the GDB project, where it's policy to require documentation changes with each user-visible change. Every contributor is required to comply, and there's a standing proposal fo= r those who don't feel themselves well in Texinfo to write their docs i= n plain text, which the documentation maintainer (yours truly) will the= n convert to Texinfo by adding the necessary markup. The result? Everyone complies without complaining, and I didn't yet have even one person asking me to make good on that promise. I see no reason why it cannot work in Emacs, if we ever decide to go that way. But even if we don't, this experience proves that your assertions about Texinfo being a barrier are simply false.