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: More metaproblem Date: Thu, 04 Dec 2014 19:37:58 +0200 Message-ID: <83k32748p5.fsf@gnu.org> References: <20141203142859.24393.98673@vcs.savannah.gnu.org> <20141203192721.GE12748@thyrsus.com> <547F6774.50700@cs.ucla.edu> <838uio5vjw.fsf@gnu.org> <20141203211447.GB15111@thyrsus.com> <871toge5zw.fsf@floss.red-bean.com> <83388v6hsq.fsf@gnu.org> <85zjb3q06b.fsf@stephe-leake.org> Reply-To: Eli Zaretskii NNTP-Posting-Host: plane.gmane.org X-Trace: ger.gmane.org 1417714688 4038 80.91.229.3 (4 Dec 2014 17:38:08 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 4 Dec 2014 17:38:08 +0000 (UTC) Cc: stephen_leake@stephe-leake.org, emacs-devel@gnu.org To: Stefan Monnier Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Dec 04 18:38:00 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 1XwaLo-0001ee-8s for ged-emacs-devel@m.gmane.org; Thu, 04 Dec 2014 18:38:00 +0100 Original-Received: from localhost ([::1]:46922 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XwaLn-0001in-TB for ged-emacs-devel@m.gmane.org; Thu, 04 Dec 2014 12:37:59 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:51154) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XwaLh-0001id-6W for emacs-devel@gnu.org; Thu, 04 Dec 2014 12:37:58 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1XwaLZ-0008EV-R0 for emacs-devel@gnu.org; Thu, 04 Dec 2014 12:37:53 -0500 Original-Received: from mtaout28.012.net.il ([80.179.55.184]:50591) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1XwaLZ-0008DH-Ij for emacs-devel@gnu.org; Thu, 04 Dec 2014 12:37:45 -0500 Original-Received: from conversion-daemon.mtaout28.012.net.il by mtaout28.012.net.il (HyperSendmail v2007.08) id <0NG200700JG8ZV00@mtaout28.012.net.il> for emacs-devel@gnu.org; Thu, 04 Dec 2014 19:35:19 +0200 (IST) Original-Received: from HOME-C4E4A596F7 ([87.69.4.28]) by mtaout28.012.net.il (HyperSendmail v2007.08) with ESMTPA id <0NG20088ZJIU3500@mtaout28.012.net.il>; Thu, 04 Dec 2014 19:35:19 +0200 (IST) In-reply-to: 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.184 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:178841 Archived-At: > From: Stefan Monnier > Date: Thu, 04 Dec 2014 10:35:24 -0500 > Cc: emacs-devel@gnu.org > > And it should be kept as short as possible (e.g. things like formatting > of references to particular revisions is the kind of nitpicking we > don't need in there). I think this requirement raises the bar impossibly high. You cannot have a useful set of instructions that leave those out. E.g., this whole discussion started because of such "nitpicking". Neither do I see why would we need to restrict ourselves like that. A document with a clear structure and a list of topics at the beginning can be longish and still useful. OTOH, having instructions scattered over several files makes discovery harder.