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: Sat, 06 Dec 2014 13:01:57 +0200 Message-ID: <8361dp11p6.fsf@gnu.org> References: <20141205123549.GA29331@thyrsus.com> <2815659.zRQ0WWWeRr@descartes> <20141205175810.GD3120@thyrsus.com> <87lhmlncb1.fsf@earlgrey.lan> <20141205193643.GB5067@thyrsus.com> <87tx19rd1b.fsf@fencepost.gnu.org> <20141205215138.GF7784@thyrsus.com> <54823617.4000406@cs.ucla.edu> <83k325195l.fsf@gnu.org> <5482D94B.2070102@cs.ucla.edu> <20141206104903.GC19750@thyrsus.com> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1417863719 18623 80.91.229.3 (6 Dec 2014 11:01:59 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 6 Dec 2014 11:01:59 +0000 (UTC) Cc: eggert@cs.ucla.edu, emacs-devel@gnu.org To: esr@thyrsus.com Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat Dec 06 12:01:52 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 1XxD7X-0002AH-UK for ged-emacs-devel@m.gmane.org; Sat, 06 Dec 2014 12:01:52 +0100 Original-Received: from localhost ([::1]:54040 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxD7X-0007eO-JA for ged-emacs-devel@m.gmane.org; Sat, 06 Dec 2014 06:01:51 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:45524) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxD7Q-0007eG-JH for emacs-devel@gnu.org; Sat, 06 Dec 2014 06:01:49 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XxD7L-0008BT-Mi for emacs-devel@gnu.org; Sat, 06 Dec 2014 06:01:44 -0500 Original-Received: from mtaout27.012.net.il ([80.179.55.183]:53025) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XxD7L-0008BG-Eb for emacs-devel@gnu.org; Sat, 06 Dec 2014 06:01:39 -0500 Original-Received: from conversion-daemon.mtaout27.012.net.il by mtaout27.012.net.il (HyperSendmail v2007.08) id <0NG500D00Q8G5200@mtaout27.012.net.il> for emacs-devel@gnu.org; Sat, 06 Dec 2014 12:57:23 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout27.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NG500B5DQFMBZ20@mtaout27.012.net.il>; Sat, 06 Dec 2014 12:57:23 +0200 (IST) In-reply-to: <20141206104903.GC19750@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.183 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:179150 Archived-At: > Date: Sat, 6 Dec 2014 05:49:03 -0500 > From: "Eric S. Raymond" > Cc: Eli Zaretskii , emacs-devel@gnu.org > > Paul Eggert : > > Eli Zaretskii wrote: > > >90% of the effort of writing good documentation is not producing markup > > > > True, but if we can make the process of writing documentation even > > 5% more efficient or 5% more inviting, that could well be such a > > long-term win that it's worth the conversion hassle. > > More generally, none of the individual steps to enable new contributions > are sufficient, but they're all necessary. But the order is still important. As we all learned at some point, you start the optimization process by attacking the hot spots first. And for a good reason: doing that brings you the most return on your investments. So let's practice some good engineering and some good management, and do first things first, shall we?