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: base Date: Thu, 26 Aug 2010 09:49:39 -0400 Message-ID: References: <20100822120642.GA1794@muc.de> <87wrrg5rzg.fsf@uwakimon.sk.tsukuba.ac.jp> <87r5ho5gyr.fsf@uwakimon.sk.tsukuba.ac.jp> <87hbij6hib.fsf@uwakimon.sk.tsukuba.ac.jp> <87k4nf7ezq.fsf@catnip.gol.com> <878w3v7dd2.fsf@catnip.gol.com> <83wrrfmljv.fsf@gnu.org> <87d3t75crc.fsf@uwakimon.sk.tsukuba.ac.jp> <87fwy2g7i2.fsf@telefonica.net> <83r5hmmrz0.fsf@gnu.org> <877hjefll8.fsf@telefonica.net> <83mxsam5lh.fsf@gnu.org> <87eidm5a0n.fsf@catnip.gol.com> <87pqx5ec72.fsf@telefonica.net> Reply-To: Eli Zaretskii NNTP-Posting-Host: lo.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Trace: dough.gmane.org 1282830594 8762 80.91.229.12 (26 Aug 2010 13:49:54 GMT) X-Complaints-To: usenet@dough.gmane.org NNTP-Posting-Date: Thu, 26 Aug 2010 13:49:54 +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 Aug 26 15:49: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.69) (envelope-from ) id 1Oocpv-0008Ew-FW for ged-emacs-devel@m.gmane.org; Thu, 26 Aug 2010 15:49:47 +0200 Original-Received: from localhost ([127.0.0.1]:39053 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Oocpu-0006oh-LT for ged-emacs-devel@m.gmane.org; Thu, 26 Aug 2010 09:49:46 -0400 Original-Received: from [199.232.76.173] (port=53537 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Oocpp-0006oc-KD for emacs-devel@gnu.org; Thu, 26 Aug 2010 09:49:41 -0400 Original-Received: from Debian-exim by monty-python.gnu.org with spam-scanned (Exim 4.60) (envelope-from ) id 1Oocpo-0002z6-Bw for emacs-devel@gnu.org; Thu, 26 Aug 2010 09:49:41 -0400 Original-Received: from fencepost.gnu.org ([140.186.70.10]:58759) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1Oocpo-0002yz-45 for emacs-devel@gnu.org; Thu, 26 Aug 2010 09:49:40 -0400 Original-Received: from eliz by fencepost.gnu.org with local (Exim 4.69) (envelope-from ) id 1Oocpn-0002BI-Em; Thu, 26 Aug 2010 09:49:39 -0400 In-reply-to: <87pqx5ec72.fsf@telefonica.net> (message from =?utf-8?Q?=C3=93scar_Fuentes?= on Thu, 26 Aug 2010 15:27:29 +0200) 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:129254 Archived-At: > From: Óscar Fuentes > Date: Thu, 26 Aug 2010 15:27:29 +0200 > > Eli Zaretskii writes: > > [snip] > > > I submit that a good model does not need to be based on implementation > > details. > > In the case of git, you got this backwards. As the model is so simple, > the implementation is immediate, so when the model is explained it is > easy to get the impression that they are explained the > implementation. And vice-versa: unlike the Emacs redisplay code, it is > easy to describe the model by describing the implementation. They are > almost the same. So you are saying that there's no way a user can understand how to use git efficiently without knowing about SHA1, hashes, blobs, index files, and how they all live happily in disk files and point to one another? > If you have a mental model, I have my own and the bzr developers each > have theirs... it is a recipe for confussion when we need to > communicate, don't you think? Good documentation should cause you and me form models that are very similar if not identical. The models of the developers I don't care about, as long as they care about mine (the documentation should tell them what my model should be). > And as your model may not fit the reality > (because it is your creation based on incomplete sources) you may get > upset from time to time because the tool does not act as you expect and > the developers refuse to consider those deviations as bugs. Models need to be updated from time to time. It's inevitable.