From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Miles Bader Newsgroups: gmane.emacs.devel Subject: Re: log format for vc-bzr Date: Sat, 09 Jan 2010 04:41:29 +0900 Message-ID: <87aawo2xli.fsf@catnip.gol.com> References: <200912081747.nB8HlwPR021836@godzilla.ics.uci.edu> <874oo1w9y1.fsf@telefonica.net> <87tyw1uss6.fsf@telefonica.net> <200912082203.nB8M3FLP023771@godzilla.ics.uci.edu> <87hbs1at4u.fsf@notengoamigos.org> <871vj3sxgy.fsf@telefonica.net> <87ws0vrd46.fsf@telefonica.net> <87hbqxa9ti.fsf@ambire.localdomain> <87k4vtd1uy.fsf@telefonica.net> <83ljg9as4g.fsf@gnu.org> <873a2gkh0n.fsf@uwakimon.sk.tsukuba.ac.jp> <838wc8bxft.fsf@gnu.org> <874omwd7wx.fsf@telefonica.net> <83ocl4a60j.fsf@gnu.org> <87ocl4bie4.fsf@telefonica.net> <83ljg89ypj.fsf@gnu.org> Reply-To: Miles Bader NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Trace: ger.gmane.org 1262979719 21564 80.91.229.12 (8 Jan 2010 19:41:59 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Fri, 8 Jan 2010 19:41:59 +0000 (UTC) Cc: =?utf-8?Q?=C3=93scar?= Fuentes , emacs-devel@gnu.org To: Eli Zaretskii Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Fri Jan 08 20:41:51 2010 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([199.232.76.165]) by lo.gmane.org with esmtp (Exim 4.50) id 1NTKiR-0005u0-KM for ged-emacs-devel@m.gmane.org; Fri, 08 Jan 2010 20:41:47 +0100 Original-Received: from localhost ([127.0.0.1]:58119 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NTKiS-0001h5-54 for ged-emacs-devel@m.gmane.org; Fri, 08 Jan 2010 14:41:48 -0500 Original-Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1NTKiL-0001g7-VZ for emacs-devel@gnu.org; Fri, 08 Jan 2010 14:41:42 -0500 Original-Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1NTKiH-0001ah-3n for emacs-devel@gnu.org; Fri, 08 Jan 2010 14:41:41 -0500 Original-Received: from [199.232.76.173] (port=51135 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1NTKiG-0001aX-St for emacs-devel@gnu.org; Fri, 08 Jan 2010 14:41:36 -0500 Original-Received: from smtp12.dentaku.gol.com ([203.216.5.74]:42727) by monty-python.gnu.org with esmtps (TLS-1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.60) (envelope-from ) id 1NTKiD-00045U-Ve; Fri, 08 Jan 2010 14:41:34 -0500 Original-Received: from 218.231.177.74.eo.eaccess.ne.jp ([218.231.177.74] helo=catnip.gol.com) by smtp12.dentaku.gol.com with esmtpa (Dentaku) id 1NTKiA-0008Tp-3U; Sat, 09 Jan 2010 04:41:30 +0900 Original-Received: by catnip.gol.com (Postfix, from userid 1000) id 3E85BDF73; Sat, 9 Jan 2010 04:41:29 +0900 (JST) System-Type: x86_64-unknown-linux-gnu In-Reply-To: <83ljg89ypj.fsf@gnu.org> (Eli Zaretskii's message of "Fri, 08 Jan 2010 21:35:36 +0200") Original-Lines: 16 X-Virus-Scanned: ClamAV GOL (outbound) X-Abuse-Complaints: abuse@gol.com X-detected-operating-system: by monty-python.gnu.org: GNU/Linux 2.6 (newer, 3) X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Original-Sender: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Xref: news.gmane.org gmane.emacs.devel:119730 Archived-At: Eli Zaretskii writes: > It is this wrong POV that is one of the reasons that the current bzr > docs impose such a tremendous mental pressure on a novice who is > trying to make themselves fluent with the tool. The "novice" is going to fail unless he has _some_ mental model of how things work, and that mental model had better be something reasonably close to how the actual tool works. Dumbing-down documentation beyond a certain point simply leaves you with useless documentation, not enlightened users... -Miles -- Ich bin ein Virus. Mach' mit und kopiere mich in Deine .signature.