From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: AS31976 209.132.176.0/21 X-Spam-Status: No, score=-2.8 required=3.0 tests=AWL,BAYES_00, HEADER_FROM_DIFFERENT_DOMAINS,MSGID_FROM_MTA_HEADER,RP_MATCHES_RCVD shortcircuit=no autolearn=ham autolearn_force=no version=3.4.0 From: Tom Prince Subject: Re: git newbie problems Date: Tue, 05 Dec 2006 18:52:09 -0700 Message-ID: <20061206015209.GD12211@socrates.priv> References: <4574AC9E.3040506@gmail.com> <4574BF70.8070100@lilypond.org> <457611B9.9020907@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii NNTP-Posting-Date: Wed, 6 Dec 2006 01:53:44 +0000 (UTC) Cc: git@vger.kernel.org Return-path: Envelope-to: gcvg-git@gmane.org In-reply-to: <457611B9.9020907@gmail.com> Mail-followup-to: Graham Percival , git@vger.kernel.org Content-disposition: inline User-Agent: Mutt/1.5.11-2006-05-17 Precedence: bulk X-Mailing-List: git@vger.kernel.org Archived-At: Received: from vger.kernel.org ([209.132.176.167]) by dough.gmane.org with esmtp (Exim 4.50) id 1Grlyc-0005ou-52 for gcvg-git@gmane.org; Wed, 06 Dec 2006 02:53:38 +0100 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1759634AbWLFBxf (ORCPT ); Tue, 5 Dec 2006 20:53:35 -0500 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1759624AbWLFBxf (ORCPT ); Tue, 5 Dec 2006 20:53:35 -0500 Received: from shawidc-mo1.cg.shawcable.net ([24.71.223.10]:55855 "EHLO pd4mo1so.prod.shaw.ca" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1759634AbWLFBxf (ORCPT ); Tue, 5 Dec 2006 20:53:35 -0500 Received: from pd3mr3so.prod.shaw.ca (pd3mr3so-qfe3.prod.shaw.ca [10.0.141.179]) by l-daemon (Sun ONE Messaging Server 6.0 HotFix 1.01 (built Mar 15 2004)) with ESMTP id <0J9T00FTWX7JKZ60@l-daemon> for git@vger.kernel.org; Tue, 05 Dec 2006 18:52:31 -0700 (MST) Received: from pn2ml7so.prod.shaw.ca ([10.0.121.151]) by pd3mr3so.prod.shaw.ca (Sun Java System Messaging Server 6.2-7.05 (built Sep 5 2006)) with ESMTP id <0J9T0049TX6XUB90@pd3mr3so.prod.shaw.ca> for git@vger.kernel.org; Tue, 05 Dec 2006 18:52:31 -0700 (MST) Received: from socrates.priv ([68.148.57.191]) by l-daemon (Sun ONE Messaging Server 6.0 HotFix 1.01 (built Mar 15 2004)) with ESMTP id <0J9T00FI2X6XWNA0@l-daemon> for git@vger.kernel.org; Tue, 05 Dec 2006 18:52:09 -0700 (MST) Received: from socrates.priv (localhost [127.0.0.1]) by socrates.priv (8.13.4/8.13.4) with ESMTP id kB61q99j015398; Tue, 05 Dec 2006 18:52:09 -0700 Received: (from cougar@localhost) by socrates.priv (8.13.4/8.13.4/Submit) id kB61q9Bp015397; Tue, 05 Dec 2006 18:52:09 -0700 To: Graham Percival Sender: git-owner@vger.kernel.org On Tue, Dec 05, 2006 at 04:41:29PM -0800, Graham Percival wrote: > Greetings, > > I'm posting these problems at Han-Wen and Dscho's insistence. I'm the > documentation editor for GNU/LilyPond, so I'm reluctant to criticize > other project's documentation unless I spend an hour or more seriously > reading it. It is generally accepted that much of git documentation sucks in various ways, and people have stepped up to help fix this. The problem is that most people are already well-versed in git, which makes it harder to identify the problem areas in the documentation, and that few people unfamiliar with git post to report their problems with the documentation, or UI so that, at least on the mailinglist itself, we get little direct feedback on the documentation or UI. Thank you from the list for your contribution.