From mboxrd@z Thu Jan 1 00:00:00 1970 From: Jari Aalto Subject: Re: [PATCH] git-commit.txt: Order options alphabetically Date: Thu, 02 Dec 2010 07:35:45 +0200 Organization: Private Message-ID: <871v60u47i.fsf@picasso.cante.net> References: <1291215526-11428-1-git-send-email-jari.aalto@cante.net> <20101201165043.GF26120@burratino> <87r5e1v2g8.fsf@picasso.cante.net> <7vzkspuw8g.fsf@alter.siamese.dyndns.org> <87r5e1t93o.fsf@picasso.cante.net> <2C3777CB-2DDD-4FF5-842B-23F7EF838611@sb.org> <8762vdt7oo.fsf@picasso.cante.net> <4BA22C80-9F0C-4F5F-8DBF-3E49D3D9C36A@sb.org> Mime-Version: 1.0 Content-Type: text/plain To: git@vger.kernel.org X-From: git-owner@vger.kernel.org Thu Dec 02 06:36:09 2010 Return-path: Envelope-to: gcvg-git-2@lo.gmane.org Received: from vger.kernel.org ([209.132.180.67]) by lo.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1PO1pt-0008SU-FQ for gcvg-git-2@lo.gmane.org; Thu, 02 Dec 2010 06:36:05 +0100 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1755100Ab0LBFf7 (ORCPT ); Thu, 2 Dec 2010 00:35:59 -0500 Received: from lo.gmane.org ([80.91.229.12]:47365 "EHLO lo.gmane.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1751912Ab0LBFf6 (ORCPT ); Thu, 2 Dec 2010 00:35:58 -0500 Received: from list by lo.gmane.org with local (Exim 4.69) (envelope-from ) id 1PO1pl-0008P7-A8 for git@vger.kernel.org; Thu, 02 Dec 2010 06:35:57 +0100 Received: from a91-155-187-216.elisa-laajakaista.fi ([91.155.187.216]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 02 Dec 2010 06:35:57 +0100 Received: from jari.aalto by a91-155-187-216.elisa-laajakaista.fi with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Thu, 02 Dec 2010 06:35:57 +0100 X-Injected-Via-Gmane: http://gmane.org/ X-Complaints-To: usenet@dough.gmane.org X-Gmane-NNTP-Posting-Host: a91-155-187-216.elisa-laajakaista.fi User-Agent: Gnus/5.110011 (No Gnus v0.11) Emacs/23.2 (gnu/linux) Cancel-Lock: sha1:MoOnNDOCL9WaIKl/HRd7e8nW0ZQ= Sender: git-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: git@vger.kernel.org Archived-At: 2010-12-02 01:40 Kevin Ballard : > On Dec 1, 2010, at 3:05 PM, Jari Aalto wrote: >> That little word "primarily." You don't find anyone who learnt from >> manual page first is person is on his 20's. Google is full of Git >> videos. Guess which won the sexiest contest. > > How about me? I'm 25, I've been using git for a couple of years, and > the manpages have always been my primary documentation. And your background before that (those 5 years?). Can you say that you're an average, to fit a imagned genralized 20's audience? I'm sure you have heard how hard it is nowadays to teach programming or Software Engineering in Universities. > The videos are great at convincing people to use git. But people > always turn to the manpages in order to learn the details. "Details". You said it. They are consulted. Not to learn as a primary method per se. The manual pages are too technical; not really their fault, they are supposed to be. As "manuals" are. The progression goes: - Google, more Google, and yet more Google (or the next line swapped) - Videos, and Google blogs - Co-worker, Co-student, Co- - Git Book, The Pro Book etc. (when there is time, free of other duties). - And more Google. ... man pages at the bottom after you have used Git for some time. To add perspective: there is no manual pages in Windows. What you have is a browser that is one click away from information. Jari