From mboxrd@z Thu Jan 1 00:00:00 1970 From: "J. Bruce Fields" Subject: Re: best git practices, was Re: Git User's Survey 2007 unfinishedsummary continued Date: Thu, 25 Oct 2007 12:38:35 -0400 Message-ID: <20071025163835.GB31888@fieldses.org> References: <8fe92b430710221635x752c561ejcee14e2526010cc9@mail.gmail.com> <92320AA3-6D23-4967-818D-F7FA3962E88D@zib.de> <90325C2E-9AF4-40FB-9EFB-70B6D0174409@zib.de> <20071024194849.GH29830@fieldses.org> <86784BB7-076F-4504-BCE6-4580A7C68AAC@zib.de> <20071024212854.GB6069@xp.machine.xx> <05B279A2-98A3-45F1-9661-AB361F7CAA37@zib.de> <1193328386.4522.352.camel@cacharro.xalalinux.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Cc: Johannes Schindelin , Steffen Prohaska , git@vger.kernel.org To: Federico Mena Quintero X-From: git-owner@vger.kernel.org Thu Oct 25 18:40:17 2007 Return-path: Envelope-to: gcvg-git-2@gmane.org Received: from vger.kernel.org ([209.132.176.167]) by lo.gmane.org with esmtp (Exim 4.50) id 1Il5kX-00011u-JA for gcvg-git-2@gmane.org; Thu, 25 Oct 2007 18:40:02 +0200 Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1758602AbXJYQin (ORCPT ); Thu, 25 Oct 2007 12:38:43 -0400 Received: (majordomo@vger.kernel.org) by vger.kernel.org id S1761358AbXJYQin (ORCPT ); Thu, 25 Oct 2007 12:38:43 -0400 Received: from mail.fieldses.org ([66.93.2.214]:46787 "EHLO fieldses.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1761266AbXJYQil (ORCPT ); Thu, 25 Oct 2007 12:38:41 -0400 Received: from bfields by fieldses.org with local (Exim 4.68) (envelope-from ) id 1Il5jA-0001bA-1H; Thu, 25 Oct 2007 12:38:36 -0400 Content-Disposition: inline In-Reply-To: <1193328386.4522.352.camel@cacharro.xalalinux.org> User-Agent: Mutt/1.5.16 (2007-06-11) Sender: git-owner@vger.kernel.org Precedence: bulk X-Mailing-List: git@vger.kernel.org Archived-At: On Thu, Oct 25, 2007 at 11:06:26AM -0500, Federico Mena Quintero wrote: > So, a few problems so far, with possible solutions: > > * The docs do not make it easy to understand what git-fetch does. Can > we just cut&paste most of "Git for computer scientists" into the Git > user's manual?). It's definitely not a simple cut-and-paste--even with permission from the author of "Git for computer scientists", fitting this in would require rethinking the ordering of topics in the manual. Also, there's the restriction that we'd like to keep it looking good in plain ascii, so diagrams have to be done in ascii somehow. But as for using ideas from "Git for computer scientists", and/or rethinking the ordering of the user's manual to make it more helpful. Yes, that would be great! Let me know what I can do to help. --b.