From: Robin Rosenberg <robin.rosenberg.lists@dewire.com>
Date: Sat, 28 Oct 2006 22:18:04 GMT
Subject: Re: VCS comparison table
Message-ID: <200610290018.05884.robin.rosenberg.lists@dewire.com>
In-Reply-To: <ehvnal$tjg$1@sea.gmane.org>

lördag 28 oktober 2006 15:53 skrev Jakub Narebski:
> But for example git(7) man page lists git commands clearly divided between
> low-level commands (plumbing): manipulation commands, interrogation
> commands, synching commands and high level commands (porcelain): main
> commands, ancillary commands. The "git help" and "git --help" shows the
> most commonly used git commands with short description of each command
> ("git help -a" show all commands).

I believe people tend to skim through documentation looking for pieces of 
information rather than read it from start to end. So they find themselves 
reading the plumbing documentation first. Simply reordering documentation to 
list the porcelain commands before the plumbing would make the git man page 
less scary to newcomers.