From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: John Wiegley Newsgroups: gmane.emacs.devel Subject: Re: Next release from master Date: Thu, 11 Feb 2016 13:11:12 -0500 Message-ID: References: <8qegda3kfg.fsf@fencepost.gnu.org> <83h9i695n5.fsf@gnu.org> <87si118q6e.fsf@gnus.org> <877fid5u3e.fsf@gmx.us> <87bn7pwgaj.fsf@wanadoo.es> <87y4atqq25.fsf@gnus.org> <877fidwaka.fsf@wanadoo.es> <8737t1ckh9.fsf@gmail.com> <56BAAF79.2010109@yandex.ru> <831t8kbg7n.fsf@gnu.org> <56BCC31A.4060901@cs.ucla.edu> Reply-To: John Wiegley NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: text/plain X-Trace: ger.gmane.org 1455214306 11440 80.91.229.3 (11 Feb 2016 18:11:46 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Thu, 11 Feb 2016 18:11:46 +0000 (UTC) Cc: emacs-devel@gnu.org To: Paul Eggert Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Thu Feb 11 19:11:39 2016 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 1aTviM-0006qw-L5 for ged-emacs-devel@m.gmane.org; Thu, 11 Feb 2016 19:11:38 +0100 Original-Received: from localhost ([::1]:52409 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aTviL-0000rd-Rb for ged-emacs-devel@m.gmane.org; Thu, 11 Feb 2016 13:11:37 -0500 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:48619) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aTvi6-0000qD-Jc for emacs-devel@gnu.org; Thu, 11 Feb 2016 13:11:23 -0500 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1aTvi0-0002e4-Pj for emacs-devel@gnu.org; Thu, 11 Feb 2016 13:11:22 -0500 Original-Received: from mail-yw0-x22f.google.com ([2607:f8b0:4002:c05::22f]:36765) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1aTvi0-0002e0-Kz for emacs-devel@gnu.org; Thu, 11 Feb 2016 13:11:16 -0500 Original-Received: by mail-yw0-x22f.google.com with SMTP id q190so45678209ywd.3 for ; Thu, 11 Feb 2016 10:11:16 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:to:cc:subject:in-reply-to:date:message-id:references :user-agent:reply-to:mail-followup-to:mime-version:content-type; bh=MEA2iM6CK/P+nG+dLvIjo9NQOPEJCwyf/g6NRYKUiT8=; b=sCvasnlNmMW0t/coS3r9XxV6XIzzhU/QVYv+1TVa3j0ApEPcdDAuwhhRUbe9tA6mtu 4LeB5c+iLC9q2nwplZsMVPV3+zHxzri0cfGPYyNyqZ9Z42wvYZ2QvHcxSeUC8wG41cgA VNNd57daWYf2C/5iAdtQVjkCupZxpAGRUSmjLMqP62qxmjkMsl2NbxAKmVLhvQzMQNvH Rd6K3umLI9jUBBGk7fluvT/i0zlNRHLAWnAtN/WWVGv4t0BW9+GDiI8dXKGuoLo5sSxK BzA6o9L9Kc8FPwVDoKGilaIiSDZbERQj/panOeWAvXjz+3l532MgEn3/GI95rx8ZjBS2 ZXGA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:from:to:cc:subject:in-reply-to:date:message-id :references:user-agent:reply-to:mail-followup-to:mime-version :content-type; bh=MEA2iM6CK/P+nG+dLvIjo9NQOPEJCwyf/g6NRYKUiT8=; b=F6Q7DtUE1C/MgISYl1UUZZYaFeYJ2RMrzv7YGGM5g4J1WLONeup7/qy6Ejl/iB1GEk pwnCi/wYVo3+Pzs4YHUEiYskSwa4MBv2eXhXxmpbDsTrFt/F2EoElk5dX/hRdESfi55l +LjTIalSdZkR21IEXMwIo2EgZf3M7Tk57YiewqsVTSFySDsCPPfPwtolMTJIgegapG7S CGQVZE1uOsvMX385r2ieGta5YkXmTxizYqBvayGnSsTjwHq1V7EdtDTqlCELdwSGRAjq /7GXK19ZrFriHz+SbExM79dV02Qxt9TbI6zYDsK9tc1v+4pPhFr47YqXkh2MqNJJn55J m3Xw== X-Gm-Message-State: AG10YORmjyZQdzsxeLgf2mG5RP1UtPCgERnB8NK813/ucb1VreGtLOkvkXpGrtQJSk6kUQ== X-Received: by 10.129.130.132 with SMTP id s126mr23879496ywf.131.1455214276325; Thu, 11 Feb 2016 10:11:16 -0800 (PST) Original-Received: from Hermes.local (mail.johnwiegley.com. [208.82.103.192]) by smtp.gmail.com with ESMTPSA id g128sm7194283ywg.33.2016.02.11.10.11.15 (version=TLS1 cipher=AES128-SHA bits=128/128); Thu, 11 Feb 2016 10:11:15 -0800 (PST) X-Google-Original-From: "John Wiegley" Original-Received: by Hermes.local (Postfix, from userid 501) id 008254E10D15; Thu, 11 Feb 2016 13:11:14 -0500 (EST) In-Reply-To: <56BCC31A.4060901@cs.ucla.edu> (Paul Eggert's message of "Thu, 11 Feb 2016 09:21:30 -0800") User-Agent: Gnus/5.130014 (Ma Gnus v0.14) Emacs/24.5 (darwin) Mail-Followup-To: Paul Eggert , emacs-devel@gnu.org X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2607:f8b0:4002:c05::22f 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:199758 Archived-At: >>>>> Paul Eggert writes: > On 02/10/2016 09:58 AM, Eli Zaretskii wrote: >> the best person to write documentation of a feature is the one who made the >> change, and the best time to do that is as part of or immediately following >> the development, when all the details are still fresh in that person's >> memory. > I quite agree with this. The all-too-common habit of "write code first, hope > somebody else will document later" is a terribly inefficient way improve > Emacs, and we really should change our collective habits in this area. I've > been doing my best to document as I go, and find that this is much better -- > among other things, documenting is a good way to find bugs before they're > committed to the master branch. Can we move this discussion to another thread? It is only vaguely related to deciding what the next release from master will be. -- John Wiegley GPG fingerprint = 4710 CF98 AF9B 327B B80F http://newartisans.com 60E1 46C4 BD1A 7AC1 4BA2