git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: Adding Git to Better SCM Initiative : Comparison

From
Jakub Narebski <jnareb@gmail.com>
Date
Nov 30, 2007, 01:53 UTC
Message-ID
<200711300253.55759.jnareb@gmail.com>
In-Reply-To
<200711300226.54338.johan@herland.net>
On Fri, 30 Nov 2007, Johan Herland wrote:
Show 31 quoted lines
> On Friday 30 November 2007, Jakub Narebski wrote:
>> On Thu, 29 Nov 2007, Alex Riesen wrote:
>>> Jakub Narebski, Thu, Nov 29, 2007 03:26:12 +0100:
>> 
>>>> +             <s id="git">
>>>> +                 Medium. There's Git User's Manual, manpages, some
>>>> +                 technical documentation and some howtos.  All
>>>> +                 documentation is also available online in HTML format;
>>>> +                 there is additional information (including beginnings
>>>> +                 of FAQ) on git wiki.
>>>> +                 Nevertheles one of complaints in surveys is insufficient
>>> 
>>> "Nevertheless" (two "s").
>>> 
>>> BTW, I wouldn't call the level of documentation "Medium" when compared
>>> to any commercial SCM. How can they earn more than "a little", when
>>> compared to any opensource program?
>> 
>> Source code is not [user level] documentation.
>> 
>> But perhaps it should be "Good" instead of "Medium", although I think
>> not "Excellent".
> 
> If we try to compare ourselves to what's closest, i.e. Mercurial, I would
> say that Git's documentation is probably on par with what Mercurial has to
> offer. Their "Documentation" entry in the comparison is as follows:
> 
> "Very good. There's an overview and tutorial on the web site, and integrated
> help for every command."
> 
> I say we go for something similar.

Well, at least according to surveys results people perceive "The Mercurial Book" (hgbook) as better documentation than "Git User's Manual" + tutorials. See for example frequent requests for "The Git Book" patterned after hgbook and/or svnbook.

BTW. the list was meant to be updated by contributors who added SCMs, but it doesn't liik lik it is...

-- 
Jakub Narebski
Poland
Previous: Johan HerlandNext: Alex Riesen
Message 8 of 11 in “Adding Git to Better SCM Initiative : Comparison”
  1. Jakub NarebskiNov 28, 2007
  2. Robin RosenbergNov 29, 2007
  3. Jan HudecNov 29, 2007
  4. Jakub NarebskiNov 29, 2007
  5. Alex RiesenNov 29, 2007
  6. Jakub NarebskiNov 30, 2007
  7. Johan HerlandNov 30, 2007
  8. Jakub NarebskiNov 30, 2007
  9. Alex RiesenNov 30, 2007
  10. Jan HudecNov 30, 2007
  11. Jakub NarebskiDec 3, 2007

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.