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: Thu, 11 Dec 2014 19:40:16 +0200 Message-ID: <838uiet79b.fsf@gnu.org> References: <20141205123549.GA29331@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> <5484FF31.5010808@cs.ucla.edu> <5485FC59.5030700@cs.ucla.edu> <87388p6glt.fsf@engster.org> <871to9lw6g.fsf@fencepost.gnu.org> <5486A704.6090305@cs.ucla.edu> <87k321jj4e.fsf@fencepost.gnu.org> <54876F7F.9000607@cs.ucla.edu> <87y4qfj2u9.fsf@fencepost.gnu.org> <54889A57.5060905@cs.ucla.edu> <87vbljb9f4.fsf@wanadoo.es> <54889F6D.6060408@cs.ucla.edu> <87r3w7b83a.fsf@wanadoo.es> <5488C710.3000209@cs.ucla.edu> <871to7ayv9.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: QUOTED-PRINTABLE X-Trace: ger.gmane.org 1418319668 15058 80.91.229.3 (11 Dec 2014 17:41:08 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 11 Dec 2014 17:41:08 +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 Thu Dec 11 18:41:01 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 1Xz7jX-0003bb-14 for ged-emacs-devel@m.gmane.org; Thu, 11 Dec 2014 18:40:59 +0100 Original-Received: from localhost ([::1]:52811 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xz7jW-0000g9-In for ged-emacs-devel@m.gmane.org; Thu, 11 Dec 2014 12:40:58 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:35584) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xz7j0-0000f0-Ez for emacs-devel@gnu.org; Thu, 11 Dec 2014 12:40:32 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1Xz7is-0002Jf-5K for emacs-devel@gnu.org; Thu, 11 Dec 2014 12:40:25 -0500 Original-Received: from mtaout26.012.net.il ([80.179.55.182]:44876) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1Xz7ir-0002IR-Ul for emacs-devel@gnu.org; Thu, 11 Dec 2014 12:40:18 -0500 Original-Received: from conversion-daemon.mtaout26.012.net.il by mtaout26.012.net.il (HyperSendmail v2007.08) id <0NGF00A00HYJNO00@mtaout26.012.net.il> for emacs-devel@gnu.org; Thu, 11 Dec 2014 19:39:16 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout26.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NGF0001JIDGCHA0@mtaout26.012.net.il>; Thu, 11 Dec 2014 19:39:16 +0200 (IST) In-reply-to: <871to7ayv9.fsf@wanadoo.es> 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.182 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:179805 Archived-At: > From: =C3=93scar Fuentes > Date: Thu, 11 Dec 2014 00:06:34 +0100 >=20 > 1. the author of the change shall convey the information on the > documentation. >=20 > 2. checking the resulting document in terms of appearance criteria = can > be done by another individual. >=20 > 3. checking the resulting document in terms of clarity, completenes= s, > style, etc. *must* be done by someone who is not the author. >=20 > For you as the author, it is a good thing to do 1 ASAP. If the > documentation tool allows you to do the job without "building the d= ocs" > to check that you didn't break the build, etc., you stop caring abo= ut > the speed of that process. As I wrote elsewhere, I don't see how a tool can do that without performing most of the job done by makeinfo. Without that, invalid cross-references and node prev/next/up pointers might be left incorrect. And don't forget pointers to other manuals, > But we can delay 2 and 3 until a late stage of the development cycl= e. This means the development version is incomplete for most of the time. Yes, we have this now, but I hope to change that. Since many distributions provide snapshots of Emacs, we should strive to have ou= r docs in good shape at all times. I also have hard time to imagine we will find volunteers for 2: it's = a mundane, boring job that no one is motivated to do except the author.