Re: best git practices, was Re: Git User's Survey 2007 unfinishedsummary continued

From: Andreas Ericsson <ae@op5.se>
Date: Oct 25, 2007, 20:19 UTC
Message-ID: <4720FA6E.9040805@op5.se>
In-Reply-To: <1193335562.4522.403.camel@cacharro.xalalinux.org>

Federico Mena Quintero wrote:

Show 9 quoted lines

> On Thu, 2007-10-25 at 12:38 -0400, J. Bruce Fields wrote:
> 
>> 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.
> 
> Oh, that can be done.  It's easier to move text around than to
> rearchitect code :)
>

It misses the point though. Machines should work while humans are lounging. If the humans have to read a lot to get the machines to work, there's less time for lounging ;-)

Show 8 quoted lines

>> 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.
> 
> Hmm, what's the rationale for this?  I'd assume that most people read
> the user's manual as a web page (or as bedside reading if they can print
> a PDF thereof), where diagrams can be pretty.
>

man pages.

-- 
Andreas Ericsson                   andreas.ericsson@op5.se
OP5 AB                             www.op5.se
Tel: +46 8-230225                  Fax: +46 8-230231