git-scm.com

git-scm.com

[Scott Chacon]

Hey all,

A followup on the post I did a few days ago about Git documentation.
I forked Petr's git.or.cz site and put up a version that I think is a
bit more accessible and newbie-friendly at git-scm.com.  I had meant
to discuss this with Petr before posting it to you all, but I
published a blog post that got a bit more attention than I expected,
and I didn't want you all to think I didn't care about your opinion,
as some have already accused me of.

Anyhow, I'm discussing with Petr about where we want to go from here -
what changes he'd like to make, etc, but I obviously value your
opinion as well, so please let me know what you think.  The content
has barely changed, it's really just a usability overhaul.  I want to
make sure that whatever someone is looking for (especially someone
new), they can find in a few clicks and a few seconds.

Next, I will be working on the larger end-user documentation project,
which will linked to from the documentation page of this site, and
probably the main page too.  I'll keep this list updated as I go,
since people tend to think I don't care about the community when I try
not to waste your time. :)

Scott

Re: git-scm.com

[Sverre Rabbelier]

On Fri, Jul 25, 2008 at 19:35, Scott Chacon <schacon@gmail.com> wrote:
> A followup on the post I did a few days ago about Git documentation.
> I forked Petr's git.or.cz site and put up a version that I think is a
> bit more accessible and newbie-friendly at git-scm.com.  I had meant
> to discuss this with Petr before posting it to you all, but I
> published a blog post that got a bit more attention than I expected,
> and I didn't want you all to think I didn't care about your opinion,
> as some have already accused me of.

I had a looksie at the site and I think the documentation section [0]
could use some TLC. It might be because it's getting late, but there's
not really any 'eye catchers', no "CLICK ME!" link for someone
browsing around looking for Documentation. In order to find what you
want you have to read -a lot- of the page, which I think is a sign
that the page would do well with some TLC ;).
Now I'll admit that the git.or.cz version [1] is a lot worse, but with
this being an attempt to make it a lot more newbie friendly...

[0] http://git-scm.com/documentation
[1] http://git.or.cz/gitwiki/GitDocumentation

PS: I think you forgot the </shameless plug> when you did put up your
own e-book in the books section but did not put "Git Magic" there ;).

-- 
Cheers,

Sverre Rabbelier

Re: git-scm.com

[Johan Herland]

On Friday 25 July 2008, Scott Chacon wrote:
> Hey all,
>
> A followup on the post I did a few days ago about Git documentation.
> I forked Petr's git.or.cz site and put up a version that I think is a
> bit more accessible and newbie-friendly at git-scm.com.  I had meant
> to discuss this with Petr before posting it to you all, but I
> published a blog post that got a bit more attention than I expected,
> and I didn't want you all to think I didn't care about your opinion,
> as some have already accused me of.
>
> Anyhow, I'm discussing with Petr about where we want to go from here -
> what changes he'd like to make, etc, but I obviously value your
> opinion as well, so please let me know what you think.  The content
> has barely changed, it's really just a usability overhaul.  I want to
> make sure that whatever someone is looking for (especially someone
> new), they can find in a few clicks and a few seconds.

Thanks for the update. Looks good.

Minor niggle: On the download page, in the Binaries table, Cygwin is listed 
before msysGit. I'm under the impression that msysGit is what we really 
want to be pushing on Windows (it's faster, smaller, and less strange to 
Windows-people (i.e. less Unix-y)), so you might want to switch the order 
around.


Have fun!

...Johan

-- 
Johan Herland, <johan@herland.net>
www.herland.net

Re: git-scm.com

[Scott Chacon]

I mean to have the new documentation I'm beginning be the
'eye-catcher' on that page eventually.  Not because it's done by me,
but because it will be open and I want to encourage people to
contribute to it (we must make it perfect, after all) :)  However, the
big thing is that I couldn't think of a _single_ resource that I would
want to point people at.  I tried to split everything up
categorically, but I don't know what you're looking for being there
exactly.  Thanks for the feedback, though, I'll see what I can do.

As for my own plug, I feel kinda bad about that, but I have gotten a
lot of feedback that it's a useful resource and I thought by
separating it out into a 'books' section, I had cleanly distinguished
between the corporate sellouts and everyone else :)  I have Git Magic
in the Tutorials section, including a nice plug for it and a link to
it's source on Github - if it were an e-book (had a pdf version and a
cover) I would happily put it over there.  I would like, however, to
keep the downloadable resources seperate from the free online
resources (though now that I think about it, I should probably put
"Git from the Bottom Up" pdf up there somewhere...).  I want people to
know they have to shell out money for those greedy bastards projects,
though.  There will be an O'Reilly book soon, and I'll put that up,
too. If you have other resources that you think are really good, let
me know so I can add them.

Scott

On Fri, Jul 25, 2008 at 2:20 PM, Sverre Rabbelier <alturin@gmail.com> wrote:
> On Fri, Jul 25, 2008 at 19:35, Scott Chacon <schacon@gmail.com> wrote:
>> A followup on the post I did a few days ago about Git documentation.
>> I forked Petr's git.or.cz site and put up a version that I think is a
>> bit more accessible and newbie-friendly at git-scm.com.  I had meant
>> to discuss this with Petr before posting it to you all, but I
>> published a blog post that got a bit more attention than I expected,
>> and I didn't want you all to think I didn't care about your opinion,
>> as some have already accused me of.
>
> I had a looksie at the site and I think the documentation section [0]
> could use some TLC. It might be because it's getting late, but there's
> not really any 'eye catchers', no "CLICK ME!" link for someone
> browsing around looking for Documentation. In order to find what you
> want you have to read -a lot- of the page, which I think is a sign
> that the page would do well with some TLC ;).
> Now I'll admit that the git.or.cz version [1] is a lot worse, but with
> this being an attempt to make it a lot more newbie friendly...
>
> [0] http://git-scm.com/documentation
> [1] http://git.or.cz/gitwiki/GitDocumentation
>
> PS: I think you forgot the </shameless plug> when you did put up your
> own e-book in the books section but did not put "Git Magic" there ;).
>
> --
> Cheers,
>
> Sverre Rabbelier
>

Re: git-scm.com

[Scott Chacon]

Actually, that's directly from git.or.cz - I thought about removing
the Cygwin one, but perhaps swapping the order would be better.  Any
thoughts?

Scott

On Fri, Jul 25, 2008 at 2:36 PM, Johan Herland <johan@herland.net> wrote:
> On Friday 25 July 2008, Scott Chacon wrote:
>> Hey all,
>
> Thanks for the update. Looks good.
>
> Minor niggle: On the download page, in the Binaries table, Cygwin is listed
> before msysGit. I'm under the impression that msysGit is what we really
> want to be pushing on Windows (it's faster, smaller, and less strange to
> Windows-people (i.e. less Unix-y)), so you might want to switch the order
> around.
>
>
> Have fun!
>
> ...Johan
>
> --
> Johan Herland, <johan@herland.net>
> www.herland.net
>

Re: git-scm.com

[Stephan Beyer]

Hi,

Just a very short note: I like it ;-)
Amusing picture.

You perhaps should switch the page encoding to utf-8, since many
names of contributors are broken without.
I've just taken a view at the XHTML. You have:
	<?xml version="1.0" encoding="iso-8859-1" ?>
But:
	<meta http-equiv="content-type" content="text/html; charset=UTF-8" />

And the HTTP server does not set an encoding, as it seems, which is ok.
So please change the first line to
	<?xml version="1.0" encoding="UTF-8"?>

Thanks,
  Stephan

-- 
Stephan Beyer <s-beyer@gmx.net>, PGP 0x6EDDD207FCC5040F

Re: git-scm.com

[Scott Chacon]

Thanks - we're working on validating the pages now.  This should be
fixed shortly.

Scott

On Fri, Jul 25, 2008 at 3:02 PM, Stephan Beyer <s-beyer@gmx.net> wrote:
> Hi,
>
> Just a very short note: I like it ;-)
> Amusing picture.
>
> You perhaps should switch the page encoding to utf-8, since many
> names of contributors are broken without.
> I've just taken a view at the XHTML. You have:
>        <?xml version="1.0" encoding="iso-8859-1" ?>
> But:
>        <meta http-equiv="content-type" content="text/html; charset=UTF-8" />
>
> And the HTTP server does not set an encoding, as it seems, which is ok.
> So please change the first line to
>        <?xml version="1.0" encoding="UTF-8"?>
>
> Thanks,
>  Stephan
>
> --
> Stephan Beyer <s-beyer@gmx.net>, PGP 0x6EDDD207FCC5040F
>

Re: git-scm.com

[Junio C Hamano]

I think counting merges in "The Authors of Git" statistics give quite
skewed numbers.  If you are generating it with "shortlog", you probably
would want to give --no-merges to the command line as well.  Also it
appears that you are not using .mailmap to avoid counting the same person
as different people.

I find a tabular list like this list easier to read if it were sorted like
this:

	A	D	G
        B	E	H
        C	F

i.e. not like this:

	A	B	C
        D	E	F
        G	H

Re: git-scm.com

[Scott Chacon]

Thanks Junio,

I fixed the things you mentioned here, except for the list ordering,
only because I kinda think you big contributors should be at the top
there, and also because it's slightly more difficult to populate an
html table that way :)  If everyone feels strongly about that, though,
I will change it.

Scott



On Fri, Jul 25, 2008 at 4:47 PM, Junio C Hamano <gitster@pobox.com> wrote:
> I think counting merges in "The Authors of Git" statistics give quite
> skewed numbers.  If you are generating it with "shortlog", you probably
> would want to give --no-merges to the command line as well.  Also it
> appears that you are not using .mailmap to avoid counting the same person
> as different people.
>
> I find a tabular list like this list easier to read if it were sorted like
> this:
>
>        A       D       G
>        B       E       H
>        C       F
>
> i.e. not like this:
>
>        A       B       C
>        D       E       F
>        G       H
>
>

Re: git-scm.com

[Patrick Aljord]

Looks fine but this page looks like a big advertising for Github with
five links on the middle of the front page + one big logo at the
bottom.

Re: git-scm.com

[Johannes Schindelin]

Hi,

On Fri, 25 Jul 2008, Scott Chacon wrote:

> A followup on the post I did a few days ago about Git documentation.
> I forked Petr's git.or.cz site and put up a version that I think is a
> bit more accessible and newbie-friendly at git-scm.com.

I do not like the implication that Git eats trees.

I also do not like that the link to "Documentation" looks more like a 
too-short cheat-sheet.

> I had meant to discuss this with Petr before posting it to you all, but 
> I published a blog post that got a bit more attention than I expected, 
> and I didn't want you all to think I didn't care about your opinion, as 
> some have already accused me of.

My first reaction was: he could have given Pasky a little more time to 
react.

But then, I think that git.or.cz looks more professional (read: more 
respectful, less geekish), so I think there is not much harm in that.

Ciao,
Dscho

Re: git-scm.com

[Scott Chacon]

5 links in the middle?  You mean to the project links?  I just choose
the biggest, most well known projects I could think of and stuck them
up there - many of them are at GitHub.  If you have a list you like
better, I would be happy to add them, or discuss the final list, but I
hardly think that's an advertisement for GitHub.  As for the link in
the footer, that's where I'm hosting my repo for the page, and it's at
the bottom of the page and tiny.

I am more concerned about the logo at the bottom, and Petr and I are
discussing this - I can remove the logo, but then I'd have to pay for
this out of my pocket instead of having a small logo on the page.
It's not bad to host a few webpages, but this will eventually have
diagrams and screencasts and whatever else I can do for comprehensive
documentation, which can add up in brandwidth costs (especially the
screencasts).  The Githubbers have offered to pay for that and host
media and whatnot for the project, backed by a real team of sysadmins.
 That seems like a pretty good deal for a small logo at the bottom of
the page.  For newbies, that is likely even a good thing - makes them
see that there is some corporate interest in it - that it's not just
an obscure tool for the hard core.

I am open to discussion on that, but I can't change where Ruby on
Rails has decided to host their repo.

Scott

On Fri, Jul 25, 2008 at 6:38 PM, Patrick Aljord <patcito@gmail.com> wrote:
> Looks fine but this page looks like a big advertising for Github with
> five links on the middle of the front page + one big logo at the
> bottom.
> --
> To unsubscribe from this list: send the line "unsubscribe git" in
> the body of a message to majordomo@vger.kernel.org
> More majordomo info at  http://vger.kernel.org/majordomo-info.html
>

Re: git-scm.com

[Petr Baudis]

  Hi,

On Sat, Jul 26, 2008 at 04:25:16AM +0200, Johannes Schindelin wrote:
> On Fri, 25 Jul 2008, Scott Chacon wrote:
> 
> > A followup on the post I did a few days ago about Git documentation.
> > I forked Petr's git.or.cz site and put up a version that I think is a
> > bit more accessible and newbie-friendly at git-scm.com.
> 
> I do not like the implication that Git eats trees.

  yes, I keep wondering about the logo as well. On one side it is rather
amusing, on the other side... somehow it didn't win my heart over and it
*does* look somewhat unprofessional.

> I also do not like that the link to "Documentation" looks more like a 
> too-short cheat-sheet.

  I personally don't find the idea of having direct links to the most
used commands bad, though I'm not sure how useful will it be in
practice.

> But then, I think that git.or.cz looks more professional (read: more 
> respectful, less geekish), so I think there is not much harm in that.

  Note that I tried to fix up a lot of bits that I felt were a little
too colloquial in my patch series I linked in a previous mail.

-- 
				Petr "Pasky" Baudis
As in certain cults it is possible to kill a process if you know
its true name.  -- Ken Thompson and Dennis M. Ritchie

Re: git-scm.com

[Petr Baudis]

  Hi,

On Fri, Jul 25, 2008 at 07:28:32PM -0700, Scott Chacon wrote:
> I am more concerned about the logo at the bottom, and Petr and I are
> discussing this - I can remove the logo, but then I'd have to pay for
> this out of my pocket instead of having a small logo on the page.

  I actually think that this is *one* reference to GitHub that is
perfectly and 100% okay; if it is sponsoring the hosting, it deserves
the logo, and it is fairly non-intrusive. I _am_ watching out warily
for excessive GitHub references within the rest of the site - if only
because I have kind of personal interest in a competitor of GitHub and
thus don't want GitHub to get unwarranted free advertising. :-)

				Petr "Pasky" Baudis

Re: git-scm.com

[Johannes Schindelin]

Hi,

On Fri, 25 Jul 2008, Scott Chacon wrote:

> 5 links in the middle?

What 5 links in the middle?

*scrolls down*

Ah, the top-posting syndrome.

Old quote, but more valid than ever:

A: Because it messes up the order in which people normally read text.
Q: Why is top-posting such a bad thing?
A: Top-posting.
Q: What is the most annoying thing on usenet and in e-mail?

I find it almost comical that people do not realize how unnaturally they 
behave, and how hard they make it on their recipients, when they top-post.

Oh, and usually, I take top-posting as a clear sign that the poster is not 
worth replying to.  Take this mail as a sign that I take care of what you 
said, _in spite of_ your top-posting.

Ciao,
Dscho

Re: git-scm.com

[david]

On Sat, 26 Jul 2008, Petr Baudis wrote:

>  Hi,
>
> On Fri, Jul 25, 2008 at 07:28:32PM -0700, Scott Chacon wrote:
>> I am more concerned about the logo at the bottom, and Petr and I are
>> discussing this - I can remove the logo, but then I'd have to pay for
>> this out of my pocket instead of having a small logo on the page.
>
>  I actually think that this is *one* reference to GitHub that is
> perfectly and 100% okay; if it is sponsoring the hosting, it deserves
> the logo, and it is fairly non-intrusive. I _am_ watching out warily
> for excessive GitHub references within the rest of the site - if only
> because I have kind of personal interest in a competitor of GitHub and
> thus don't want GitHub to get unwarranted free advertising. :-)
>
> 				Petr "Pasky" Baudis

since this is a Ruby on Rails site, could the 'five links' that have been 
bothering people be randomly selected? if every time you go to the site 
you get a different list of projects it show how broadly git is used. it's 
not as 'in your face' as managing to select five that cause people to say 
"wow, they're using this", but different people will react to different 
sites.

if this table gets populated by GitHub, kernel.org, and a couple other 
sources it should be vendor independant enough (and we need a table like 
this anyway for the 'list of projects that use git', so it serves two 
purposes)

David Lang

Re: git-scm.com

[Stephan Beyer]

Johannes Schindelin wrote:
> I do not like the implication that Git eats trees.

Eridius said on IRC:
 "it's a Git", "he's a Blob that's Committed to storing Trees"


I still like the picture, though it can hurt environmentalists.

Regards,
  Stephan

-- 
Stephan Beyer <s-beyer@gmx.net>, PGP 0x6EDDD207FCC5040F

Re: git-scm.com

[Johannes Schindelin]

Hi,

On Sat, 26 Jul 2008, Stephan Beyer wrote:

> Johannes Schindelin wrote:
> > I do not like the implication that Git eats trees.
> 
> I still like the picture, though it can hurt environmentalists.

It's not just environmentalists.  If I put myself in the shoes of a Git 
newbie, I would get the impression that Git eats my trees, i.e. destroys 
them.

Very good first impression.

Not,
Dscho

Re: git-scm.com

[Scott Chacon]

On Fri, Jul 25, 2008 at 8:07 PM, Johannes Schindelin
<Johannes.Schindelin@gmx.de> wrote:
> Hi,
>
> On Sat, 26 Jul 2008, Stephan Beyer wrote:
>
>> Johannes Schindelin wrote:
>> > I do not like the implication that Git eats trees.
>>
>> I still like the picture, though it can hurt environmentalists.
>
> It's not just environmentalists.  If I put myself in the shoes of a Git
> newbie, I would get the impression that Git eats my trees, i.e. destroys
> them.
>
> Very good first impression.
>
> Not,
> Dscho
>
>

I was a bit concerned about using the little guy too, but I've gotten
overall very good feedback about him - people seem to like him.  I
think it's good to have a little bit of illustration on a page.
However, as for your concerns, I think a) it's really hard to argue
that environmentalists would actually care what that thing is doing
and b) a newbie to Git will have no idea what a 'tree' is - that is
really only a sort of inside joke.  You would have to have been using
git for a good amount of time to know that 'eating a tree' would be a
bad thing.  That's why I've been telling people that he's _storing_
trees and that you don't want to be around when he 'gc --prune's :)

Scott "not top-posting" Chacon

Re: git-scm.com

[Scott Chacon]

On Fri, Jul 25, 2008 at 7:47 PM,  <david@lang.hm> wrote:
> On Sat, 26 Jul 2008, Petr Baudis wrote:
>
>>  Hi,
>>
>> On Fri, Jul 25, 2008 at 07:28:32PM -0700, Scott Chacon wrote:
>>>
>>> I am more concerned about the logo at the bottom, and Petr and I are
>>> discussing this - I can remove the logo, but then I'd have to pay for
>>> this out of my pocket instead of having a small logo on the page.
>>
>>  I actually think that this is *one* reference to GitHub that is
>> perfectly and 100% okay; if it is sponsoring the hosting, it deserves
>> the logo, and it is fairly non-intrusive. I _am_ watching out warily
>> for excessive GitHub references within the rest of the site - if only
>> because I have kind of personal interest in a competitor of GitHub and
>> thus don't want GitHub to get unwarranted free advertising. :-)
>>
>>                                Petr "Pasky" Baudis
>
> since this is a Ruby on Rails site, could the 'five links' that have been
> bothering people be randomly selected? if every time you go to the site you
> get a different list of projects it show how broadly git is used. it's not
> as 'in your face' as managing to select five that cause people to say "wow,
> they're using this", but different people will react to different sites.
>
> if this table gets populated by GitHub, kernel.org, and a couple other
> sources it should be vendor independant enough (and we need a table like
> this anyway for the 'list of projects that use git', so it serves two
> purposes)
>
> David Lang
>

I would really like to have the big ones there all the time ('Linux',
'Ruby on Rails', 'WINE', 'X.org', etc)  Prototype and MooTools are
pretty big in the web dev world, which a lot of people are starting to
come from - at least Prototype should be there all the time.  For the
rest, if we want to pool a bunch of other projects from different
places, that would be cool, but they should be active - I don't want
people clicking on something above the fold and getting a dead
project.  If someone wants to help me vet a list, I'd be happy to do
that.

However, that being said, it's going to be difficult to have Github
projects not dominate the list a bit.  The fact is that it hosts far,
far more projects than any other single hosting service.  Just in
fully public projects, the current stats (from the website pages) are
something like this:

kernel.org : 475
repo.or.cz : 1,553
gitorious   : 780
github       : 10,560

It hosts far more than that if you include private projects, too.  So,
if we want to choose totally randomly, it's going to be at least a 5:1
ratio between github projects and all other public hosting providers.
If anything, statistically, the current list is conservative in it's
links to github projects.  For me to avoid using them is artificially
punishing them for having paid plans, which is silly.

Scott

Re: git-scm.com

[Patrick Aljord]

How about linking to the project web page or the official blog where
the move was announced when available? I think that's how it's done on
the mercurial page. And it explains people why the switch was done
rather then linking to a source repository they might not care about
and the link to the project page might give a hint about the
importance of the given project for those that might not know it (such
as prototype, mootools or liftweb).

example:
http://weblog.rubyonrails.org/2008/4/2/rails-is-moving-from-svn-to-git

Re: git-scm.com

[david]

On Fri, 25 Jul 2008, Scott Chacon wrote:

> On Fri, Jul 25, 2008 at 7:47 PM,  <david@lang.hm> wrote:
>> On Sat, 26 Jul 2008, Petr Baudis wrote:
>>
>>>  Hi,
>>>
>>> On Fri, Jul 25, 2008 at 07:28:32PM -0700, Scott Chacon wrote:
>>>>
>>>> I am more concerned about the logo at the bottom, and Petr and I are
>>>> discussing this - I can remove the logo, but then I'd have to pay for
>>>> this out of my pocket instead of having a small logo on the page.
>>>
>>>  I actually think that this is *one* reference to GitHub that is
>>> perfectly and 100% okay; if it is sponsoring the hosting, it deserves
>>> the logo, and it is fairly non-intrusive. I _am_ watching out warily
>>> for excessive GitHub references within the rest of the site - if only
>>> because I have kind of personal interest in a competitor of GitHub and
>>> thus don't want GitHub to get unwarranted free advertising. :-)
>>>
>>>                                Petr "Pasky" Baudis
>>
>> since this is a Ruby on Rails site, could the 'five links' that have been
>> bothering people be randomly selected? if every time you go to the site you
>> get a different list of projects it show how broadly git is used. it's not
>> as 'in your face' as managing to select five that cause people to say "wow,
>> they're using this", but different people will react to different sites.
>>
>> if this table gets populated by GitHub, kernel.org, and a couple other
>> sources it should be vendor independant enough (and we need a table like
>> this anyway for the 'list of projects that use git', so it serves two
>> purposes)
>>
>> David Lang
>>
>
> I would really like to have the big ones there all the time ('Linux',
> 'Ruby on Rails', 'WINE', 'X.org', etc)  Prototype and MooTools are
> pretty big in the web dev world, which a lot of people are starting to
> come from - at least Prototype should be there all the time.  For the
> rest, if we want to pool a bunch of other projects from different
> places, that would be cool, but they should be active - I don't want
> people clicking on something above the fold and getting a dead
> project.  If someone wants to help me vet a list, I'd be happy to do
> that.

I can see things going either way on this, and I'm sure that the algorithm 
for the 'best' way to select projects can be tweaked endlessly. I am not 
that afraid of someone hitting a dead link, especially if you were to list 
them as 'projects 2,4895,9287,104,18439 of xxxxxx project that have 
reported using git' with numbers that large people expect that some 
projects will have gone dead, and even if they are all live today, how 
frequently did you plan to re-check them to decide they are dead? (and 
what is your definition of dead?)

> However, that being said, it's going to be difficult to have Github
> projects not dominate the list a bit.  The fact is that it hosts far,
> far more projects than any other single hosting service.  Just in
> fully public projects, the current stats (from the website pages) are
> something like this:
>
> kernel.org : 475
> repo.or.cz : 1,553
> gitorious   : 780
> github       : 10,560
>
> It hosts far more than that if you include private projects, too.  So,
> if we want to choose totally randomly, it's going to be at least a 5:1
> ratio between github projects and all other public hosting providers.
> If anything, statistically, the current list is conservative in it's
> links to github projects.  For me to avoid using them is artificially
> punishing them for having paid plans, which is silly.

as long as there is a mechanism to add things to the list I don't see 
anything wrong with the frequency reflecting this reality. anyone who 
thinks the numbers are skewed is free to add other projects to the list.

part of this is reducing the room for people to accuse you of impropriaty, 
if you select the links people can accuse you of playing favorites, if 
it's random selection and includes competitors entire lists, it's much 
clearer that you aren't skewing things.

David Lang

Re: git-scm.com

[Martin Langhoff]

On Sat, Jul 26, 2008 at 4:55 PM, Scott Chacon <schacon@gmail.com> wrote:
> I was a bit concerned about using the little guy too, but I've gotten
> overall very good feedback about him - people seem to like him.  I
> think it's good to have a little bit of illustration on a page.

It's clearly an inside joke, but I like it. And let's have the
environmentalists-with-a-sense-of-humour with us. The others can use
something else :-)



m
-- 
 martin.langhoff@gmail.com
 martin@laptop.org -- School Server Architect
 - ask interesting questions
 - don't get distracted with shiny stuff - working code first
 - http://wiki.laptop.org/go/User:Martinlanghoff

Re: git-scm.com

[Jakub Narebski]

"Scott Chacon" <schacon@gmail.com> writes:

> A followup on the post I did a few days ago about Git documentation.
> I forked Petr's git.or.cz site and put up a version that I think is a
> bit more accessible and newbie-friendly at git-scm.com.  I had meant
> to discuss this with Petr before posting it to you all, but I
> published a blog post that got a bit more attention than I expected,
> and I didn't want you all to think I didn't care about your opinion,
> as some have already accused me of.

On thing I am curious about: how do you plan to have current version
of Git in the download / last version section?  Petr Baudis uses
custom script, which search git mailing list for "[ANNOUNCE]" posts,
and automatically updates download / last version links.

-- 
Jakub Narebski
Poland
ShadeHawk on #git

Re: git-scm.com

[Junio C Hamano]

"Patrick Aljord" <patcito@gmail.com> writes:

> How about linking to the project web page or the official blog where
> the move was announced when available? I think that's how it's done on
> the mercurial page. And it explains people why the switch was done
> rather then linking to a source repository they might not care about
> and the link to the project page might give a hint about the
> importance of the given project for those that might not know it (such
> as prototype, mootools or liftweb).

You have to work harder to do the real research to find such key
historical documents than just linking to the toplevel of the current
repository, but I think this is an excellent idea.  And most likely many
projects that have migrated from elsewhere (not the ones from scratch that
did not migrate from any existing codebase) could volunteer relevant links
if asked politely enough ;-)

Re: git-scm.com

[Petr Baudis]

On Sat, Jul 26, 2008 at 01:03:26AM -0700, Jakub Narebski wrote:
> "Scott Chacon" <schacon@gmail.com> writes:
> 
> > A followup on the post I did a few days ago about Git documentation.
> > I forked Petr's git.or.cz site and put up a version that I think is a
> > bit more accessible and newbie-friendly at git-scm.com.  I had meant
> > to discuss this with Petr before posting it to you all, but I
> > published a blog post that got a bit more attention than I expected,
> > and I didn't want you all to think I didn't care about your opinion,
> > as some have already accused me of.
> 
> On thing I am curious about: how do you plan to have current version
> of Git in the download / last version section?  Petr Baudis uses
> custom script, which search git mailing list for "[ANNOUNCE]" posts,
> and automatically updates download / last version links.

Actually, I scan the last tag on maint branch using git descirbe; the
ANNOUNCE posts are scanned by the RSS feed. Originally, git-scm scanned
kernel.org download directory for the latest tarball, but it seemed that
would break on something like the 1.4.4.5, so it also moved to the git
describe method:

	http://repo.or.cz/w/git-homepage.git?a=blob;f=update.sh
	http://github.com/schacon/learn-github/tree/master/script/get_version.rb

One Scott's concern that didn't occur to me was that a the time of
release, we could have broken links between the time tag is created and
tarballs are wrapped up. I *think* that in practice, this happens at the
same time, I wonder if Junio could confirm that.

-- 
				Petr "Pasky" Baudis
As in certain cults it is possible to kill a process if you know
its true name.  -- Ken Thompson and Dennis M. Ritchie

Re: git-scm.com

[Wincent Colaiuta]

El 26/7/2008, a las 7:30, Scott Chacon escribió:

> However, that being said, it's going to be difficult to have Github
> projects not dominate the list a bit.  The fact is that it hosts far,
> far more projects than any other single hosting service.  Just in
> fully public projects, the current stats (from the website pages) are
> something like this:
>
> kernel.org : 475
> repo.or.cz : 1,553
> gitorious   : 780
> github       : 10,560
>
> It hosts far more than that if you include private projects, too.  So,
> if we want to choose totally randomly, it's going to be at least a 5:1
> ratio between github projects and all other public hosting providers.


I think those numbers are pretty meaningless seeing as GitHub  
encourages people to publish "forks" of other projects. Rails, for  
example, has about 270 forks at the time of writing. If I scan the  
list of popular projects I see fork counts like 129, 105, 78 and 78  
(again). Are all the forks counted in that figure of 10,560 that you  
count? How many "real" projects are hosted there?

I'd like to see the "official" Git homepage as distanced as possible  
from GitHub. They've taken Git (free as in speech, free as in beer)  
and built a closed-source commercial product on top of it -- curiously  
for something which you can do for free yourself anyway -- and as far  
as I can tell from observing this mailing list and watching the  
commits going into git.git, haven't ever contributed _anything_ back  
to the community. At least within the niche that is the Ruby/Rails  
community, GitHub has basically done a hijack job and managed to  
become synonymous with Git, supplanting it, and it's a trend that I  
wouldn't like to see continue.

Just my personal opinion, but GitHub doesn't provoke any warm fuzzy  
feelings here. Quite the contrary. I actively dislike it.

Cheers,
Wincent

Re: git-scm.com

[Junio C Hamano]

"Scott Chacon" <schacon@gmail.com> writes:

> On Fri, Jul 25, 2008 at 4:47 PM, Junio C Hamano <gitster@pobox.com> wrote:
>> ...
>> I find a tabular list like this list easier to read if it were sorted like
>> this:
>>
>>        A       D       G
>>        B       E       H
>>        C       F
>> ...
>
> I fixed the things you mentioned here, except for the list ordering,
> only because I kinda think you big contributors should be at the top
> there,...

If you are going to list 30 or so top contributors in 8 rows times 4
columns, because visually the columns are much more distinct than the
rows, it makes the result look more sorted.  This is the same reasoning
hwo "git help --all" was fixed with 112d0ba (Make "git help" sort git
commands in columns, 2005-12-18).

By the way, I think this shows another issue with the "rest of us" list in
the lower half.

I have a mild suspicion that sorting that list in alphabetical order may
actually make it much better.  It all depends on the purpose of that list,
though.

The purpose of the list would most likely not to find somebody with high
activity to contact for help (you would use the top list that is sorted by
the commit count for that kind of thing).  It would primarily be to give
credit to everybody, and perhaps so that people on the contributor list
can point at their own name and say "I helped them", or find somebody else
they happen to know in the list.

When a contributor used to have 8 commits and then adds 2 commits, that
would move the name in the list by a dozen places or so with the current
set of contributors.  It would be much easier to locate one's own name
among a huge list if the names are alphabetically sorted, not by commit
count.  When more people start to contribute, your name does not move so
drastically.  If you are Adam, you are likely to find yourself near the
beginning of the list, if you are Scott, you are likely to find yourself
near one fourth from the end of the list.

And for the "giving credit" purpose, I do not think truncating the list at
5 commits or less threshold, as suggested earlier and already done, makes
much sense, either.

Re: git-scm.com

[Scott Chacon]

On Sat, Jul 26, 2008 at 8:48 AM, Wincent Colaiuta <win@wincent.com> wrote:
> El 26/7/2008, a las 7:30, Scott Chacon escribió:
>
>> However, that being said, it's going to be difficult to have Github
>> projects not dominate the list a bit.  The fact is that it hosts far,
>> far more projects than any other single hosting service.  Just in
>> fully public projects, the current stats (from the website pages) are
>> something like this:
>>
>> kernel.org : 475
>> repo.or.cz : 1,553
>> gitorious   : 780
>> github       : 10,560
>>
>> It hosts far more than that if you include private projects, too.  So,
>> if we want to choose totally randomly, it's going to be at least a 5:1
>> ratio between github projects and all other public hosting providers.
>
>
> I think those numbers are pretty meaningless seeing as GitHub encourages
> people to publish "forks" of other projects. Rails, for example, has about
> 270 forks at the time of writing. If I scan the list of popular projects I
> see fork counts like 129, 105, 78 and 78 (again). Are all the forks counted
> in that figure of 10,560 that you count? How many "real" projects are hosted
> there?

Actually, no - I was including forked projects in the repo.or.cz count
and _not_ including forks in the github count.  The actual apples to
apples count is :

Unique Projects:
  repo.or.cz: 1553
  github: 10,560

With Forks:
  repo.or.cz : 1349
  github : 16,021

Again, that is only the free, public projects - there are far more if
you include the private projects as well.  I understand that the
commercial side that is necessitated by that is uncomforting to many
people, but it is great for the adoption of Git.  Otherwise, every
company that wants to use Git professionally, including freelancers
and consultants, would have to setup, manage and maintain their own
git servers.  It should not be a precondition that in order to use Git
on a commercial project you either have to be a) a systems
administrator capable of setting up and running your own server (and
keeping it secure, etc), or b) part of an organization large enough to
have a department to take care of that for you.  Sure, you and I can
do it, and it's easy for us, but that is not true of everyone.

> I'd like to see the "official" Git homepage as distanced as possible from
> GitHub. They've taken Git (free as in speech, free as in beer) and built a
> closed-source commercial product on top of it -- curiously for something
> which you can do for free yourself anyway -- and as far as I can tell from
> observing this mailing list and watching the commits going into git.git,
> haven't ever contributed _anything_ back to the community. At least within
> the niche that is the Ruby/Rails community, GitHub has basically done a
> hijack job and managed to become synonymous with Git, supplanting it, and
> it's a trend that I wouldn't like to see continue.

Again, very few of us are excellent C programmers - I'm sure you
wouldn't want any patches we have to offer there.  We have spent
considerable time and resources on things like gitcasts (which github
sponsors for me), and on libraries and tools like ticgit (which is
being included in the next Debian release) and Grit (a ruby/git
library that runs Gitorious, and probably most other web-based Git
repos), and will be contributing back improvements to ssh libraries
that allow for the sort of traffic they have to deal with.  They have
also been looking to fund further open-source git related projects (in
case any of you are interested, btw) :

http://github.com/blog/107-supercharged-ruby-git

> Just my personal opinion, but GitHub doesn't provoke any warm fuzzy feelings
> here. Quite the contrary. I actively dislike it.
>
> Cheers,
> Wincent

I'm sorry you don't like us, but we're really not that bad.  If you're
in the SF bay area sometime, send me a note and I'll take you out for
a beer and we can discuss what else we can do :)

Scott

Re: git-scm.com

[Junio C Hamano]

Petr Baudis <pasky@suse.cz> writes:

> One Scott's concern that didn't occur to me was that a the time of
> release, we could have broken links between the time tag is created and
> tarballs are wrapped up. I *think* that in practice, this happens at the
> same time, I wonder if Junio could confirm that.

Heh, and you did not Cc: me ;-)?

There is a mirroring process involved between the public machines and the
machine I push the tag into and place the tarballs.  I do not have control
over that mirroring.  But modulo that, the tarballs and RPMs are made
public before the tag and the tips of branches are pushed into the public
repository.

The release procedure goes like this (extend this as an addendum to
Documentation/howto/maintain-git.txt if somebody feels like it):

 * On the development machine outside k.org, create the tag, and prepare
   RPM for i386;

 * scp i386 RPM to a private staging area at k.org, and push the tag to a
   private building area also at k.org;

 * run the release procedure in the private building area at k.org, which:

   - builds x86_64 RPM and deposits it to the same private staging area
     i386 RPM were scp'ed to earlier;

   - builds the source tarball and documentation tarballs;

   - puts all of the above in /pub/software/scm/git/ to be mirrored out;

   - extracts html documentation tarball in /pub/software/scm/git/docs/v*
     to be mirrored out;

         http://www.kernel.org/pub/software/scm/git/docs/, the "current"
         documentation page, has links to these "documentation for
         released versions" and they point at these docs/v* areas.

 * push the tag and branch tips out to the public repository, so that it
   will be mirrored to /pub/scm/git/git.git/ (this updates the "current"
   documentation pages as a side effect);

 * send out the release announcement message to the list.

The 1.4.4.5 backport was an oddball.  I do not think I did anything other
than simply pushing the tag out.

Re: git-scm.com

[Scott Chacon]

On Sat, Jul 26, 2008 at 12:11 PM, Johannes Schindelin
<Johannes.Schindelin@gmx.de> wrote:
> Hi Scott,
>
> On Sat, 26 Jul 2008, Scott Chacon wrote:
>
>> I'm sorry you don't like us, but we're really not that bad.  If you're
>> in the SF bay area sometime, send me a note and I'll take you out for a
>> beer and we can discuss what else we can do :)
>
> If that applies to everybody having concerns, I would love to take you up
> on your word for it.  I will be in the bay area around 24th of October
> this year.
>
> Ciao,
> Dscho

That is open to anyone that has contributed a patch to git - I at
least owe you a beer.  Let me know when you're around.

Scott

Re: git-scm.com

[Johannes Schindelin]

Hi,

On Sat, 26 Jul 2008, Scott Chacon wrote:

> On Sat, Jul 26, 2008 at 12:11 PM, Johannes Schindelin
> <Johannes.Schindelin@gmx.de> wrote:
> >
> > On Sat, 26 Jul 2008, Scott Chacon wrote:
> >
> >> I'm sorry you don't like us, but we're really not that bad.  If 
> >> you're in the SF bay area sometime, send me a note and I'll take you 
> >> out for a beer and we can discuss what else we can do :)
> >
> > If that applies to everybody having concerns, I would love to take you 
> > up on your word for it.  I will be in the bay area around 24th of 
> > October this year.
> 
> That is open to anyone that has contributed a patch to git - I at least 
> owe you a beer.

Welcome the masses:

$ git shortlog -s | wc -l
504

> Let me know when you're around.

As I said, around 24th of October this year.

Ciao,
Dscho

Re: git-scm.com

[Scott Chacon]

On Sat, Jul 26, 2008 at 12:20 PM, Johannes Schindelin
<Johannes.Schindelin@gmx.de> wrote:
> Hi,
>
> On Sat, 26 Jul 2008, Scott Chacon wrote:
>
>> On Sat, Jul 26, 2008 at 12:11 PM, Johannes Schindelin
>> <Johannes.Schindelin@gmx.de> wrote:
>> >
>> > On Sat, 26 Jul 2008, Scott Chacon wrote:
>> >
>> >> I'm sorry you don't like us, but we're really not that bad.  If
>> >> you're in the SF bay area sometime, send me a note and I'll take you
>> >> out for a beer and we can discuss what else we can do :)
>> >
>> > If that applies to everybody having concerns, I would love to take you
>> > up on your word for it.  I will be in the bay area around 24th of
>> > October this year.
>>
>> That is open to anyone that has contributed a patch to git - I at least
>> owe you a beer.
>
> Welcome the masses:
>
> $ git shortlog -s | wc -l
> 504
>
>> Let me know when you're around.
>
> As I said, around 24th of October this year.
>
> Ciao,
> Dscho
>

Heh.  That would be a hell of a night...  Nick Hengeveld said he's up
for it too, anytime.

btw, doener pointed out that I had the repo.or.cz numbers backward
earlier - it should be 1500ish with forks, 1300ish without.

Scott

Re: git-scm.com

[Junio C Hamano]

Wincent Colaiuta <win@wincent.com> writes:

> I'd like to see the "official" Git homepage as distanced as possible  
> from GitHub. They've taken Git (free as in speech, free as in beer)  
> and built a closed-source commercial product on top of it -- curiously  
> for something which you can do for free yourself anyway ...

I do not share that sentiment.  It is perfectly fine for somebody to offer
managed git repositories as a commercial _service_ to people who want to
just _use_ git.  It is what they could do themselves, but from the end
user's point of view, it's just "outsourcing" and is nothing unusual.

If GitHub folks improved the core part of the system while building their
service, we would want to get the changes back, and we will, _if_ they
distribute their software (i.e. they are not allowed to just distribute
binaries, if it links with git).

At the emotional level, if some people make the world a better place by
building new software around what I wrote, I would like to have the same
kind of access to its source as I gave them access to my sources, whether
they distribute the end product as packaged software or they offer it as a
service to be used by others without ever distributing anything.  But that
is merely my _wish_; it is different from the terms git is distributed
under.

I think you are going a bit too far to hate them for not opening up their
sources they use to implement "managed git repositories service", which is
a _user_ of the core git, but most likely is not a derivative of git
itself.  IOW, it's not your code.

Re: git-scm.com

["Peter Valdemar Mørch (Lists)"]

As a contributer with a single commit I was happy to see myself appear 
shortly on the list (yeah!). Ok, so I realize it is vanity and a little 
silly... :-)

Junio C Hamano gitster-at-pobox.com |Lists| wrote:
> I have a mild suspicion that sorting that list in alphabetical order may
> actually make it much better.  It all depends on the purpose of that list,
> though.

To me it makes sense to sort the entire list according to commits. Its 
still easy to find anybody with search, and I find it appropriate that I 
be towards the end. The commit sorting encourages me to move up the 
list! :-D

> And for the "giving credit" purpose, I do not think truncating the list at
> 5 commits or less threshold, as suggested earlier and already done, makes
> much sense, either.

And why truncate the list? I'd personally like to be back on the list 
(vanity! - but true), bandwidth is relatively cheap, and there is 
nothing below the list. I also think it makes the community look healty 
and encourages contribution to see how many others contribute.

Peter
-- 
Peter Valdemar Mørch
http://www.morch.com

Re: git-scm.com

[Petr Baudis]

On Sat, Jul 26, 2008 at 10:10:32AM -0700, Junio C Hamano wrote:
> "Scott Chacon" <schacon@gmail.com> writes:
> 
> > On Fri, Jul 25, 2008 at 4:47 PM, Junio C Hamano <gitster@pobox.com> wrote:
> >> ...
> >> I find a tabular list like this list easier to read if it were sorted like
> >> this:
> >>
> >>        A       D       G
> >>        B       E       H
> >>        C       F
> >> ...
> >
> > I fixed the things you mentioned here, except for the list ordering,
> > only because I kinda think you big contributors should be at the top
> > there,...
> 
> If you are going to list 30 or so top contributors in 8 rows times 4
> columns, because visually the columns are much more distinct than the
> rows, it makes the result look more sorted.  This is the same reasoning
> hwo "git help --all" was fixed with 112d0ba (Make "git help" sort git
> commands in columns, 2005-12-18).

Actually, this is strange for me: I would never think about reading git
help --all by rows, and I would never think about reading the authors
list by columns! It's difficult for me to point out why, possibly
because the authors list has less items per row and the items are longer
(and multi-word), but that's just a speculation. Maybe cultural
background (Japanese books are written in columns, right?) plays some
role too, I don't know.

> The purpose of the list would most likely not to find somebody with high
> activity to contact for help (you would use the top list that is sorted by
> the commit count for that kind of thing).  It would primarily be to give
> credit to everybody, and perhaps so that people on the contributor list
> can point at their own name and say "I helped them", or find somebody else
> they happen to know in the list.
> 
> When a contributor used to have 8 commits and then adds 2 commits, that
> would move the name in the list by a dozen places or so with the current
> set of contributors.  It would be much easier to locate one's own name
> among a huge list if the names are alphabetically sorted, not by commit
> count.  When more people start to contribute, your name does not move so
> drastically.  If you are Adam, you are likely to find yourself near the
> beginning of the list, if you are Scott, you are likely to find yourself
> near one fourth from the end of the list.

I don't think locating is any issue; the find function of browser is
very easy to use nowadays. I guess the purpose of the list would be
to show "I helped them this much" (i.e. "I'm high on the list"). I think
this would actually motivate contributors to move up in the ladder -
people are competitive; you might get wary about this kind of
motivation, but I believe that it is no bad thing, inherently. Heck, I
admit it does motivate even me a little, safely in the "Primary Authors"
section. :-) (These guys with their tools merged into git have unfair
advantage! You should add up also, uh, git-homepage, cogito and, um...
repo.git! *baby cry*</vanity>)

> And for the "giving credit" purpose, I do not think truncating the list at
> 5 commits or less threshold, as suggested earlier and already done, makes
> much sense, either.

The point here is that the list is awfully long and also can contain
a lot of duplicates or people with broken unicode, etc. - it gets hard
to maintain, and it makes the about page too long. I would be of course
fine with a tiny link at the bottom "(show all contributors)".

-- 
				Petr "Pasky" Baudis
As in certain cults it is possible to kill a process if you know
its true name.  -- Ken Thompson and Dennis M. Ritchie

Re: git-scm.com

[Junio C Hamano]

Petr Baudis <pasky@suse.cz> writes:

>> If you are going to list 30 or so top contributors in 8 rows times 4
>> columns, because visually the columns are much more distinct than the
>> rows, it makes the result look more sorted.  This is the same reasoning
>> hwo "git help --all" was fixed with 112d0ba (Make "git help" sort git
>> commands in columns, 2005-12-18).
>
> Actually, this is strange for me: I would never think about reading git
> help --all by rows, and I would never think about reading the authors
> list by columns! It's difficult for me to point out why, possibly
> because the authors list has less items per row and the items are longer
> (and multi-word), but that's just a speculation. Maybe cultural
> background (Japanese books are written in columns, right?) plays some
> role too, I don't know.

I do not think the default mode of "ls" output to tty (aka "ls -C") was
invented by/for Japanese people.

>> And for the "giving credit" purpose, I do not think truncating the list at
>> 5 commits or less threshold, as suggested earlier and already done, makes
>> much sense, either.
>
> The point here is that the list is awfully long and also can contain
> a lot of duplicates or people with broken unicode, etc. - it gets hard
> to maintain, and it makes the about page too long. I would be of course
> fine with a tiny link at the bottom "(show all contributors)".

Your "incentive to move up" argument suggests otherwise.  Even if it takes
efforts to maintain on somebody's part, it is worth to be inclusive, *IF*
the purpose of that bottom list is to give credits to people.

The list on the site originally was not utilizing .mailmap and I asked
Scott to use it to merge duplicate entries, which he did.  People whose
names are misspelled and/or split will now have incentive to tell Scott
about the problem so that they can clean up *their* own names, and Scott
can help maintaining .mailmap and feed the changes to me.

This is my ulterior motive behind this suggestion; I can outsource the
maintenance of .mailmap to people who care about it more than myself.

Re: git-scm.com

[Junio C Hamano]

Junio C Hamano <gitster@pobox.com> writes:

> Petr Baudis <pasky@suse.cz> writes:
> ...
>> The point here is that the list is awfully long and also can contain
>> a lot of duplicates or people with broken unicode, etc. - it gets hard
>> to maintain, and it makes the about page too long. I would be of course
>> fine with a tiny link at the bottom "(show all contributors)".
>
> Your "incentive to move up" argument suggests otherwise.  Even if it takes
> efforts to maintain on somebody's part, it is worth to be inclusive, *IF*
> the purpose of that bottom list is to give credits to people.
>
> The list on the site originally was not utilizing .mailmap and I asked
> Scott to use it to merge duplicate entries, which he did.  People whose
> names are misspelled and/or split will now have incentive to tell Scott
> about the problem so that they can clean up *their* own names, and Scott
> can help maintaining .mailmap and feed the changes to me.
>
> This is my ulterior motive behind this suggestion; I can outsource the
> maintenance of .mailmap to people who care about it more than myself.

By the way, earlier Scott gave as explanation why he and others around
GitHub, people who are not very visible on this list, are not interacting
with us very much --- because they are not "C coders".

But maintenance of .mailmap (and Documentation/ area, too, of course) is a
good example of how involvement from non "C coders" would be a helpful and
healthy thing to have in the development process, and why we do not want
to fracture the user community in two.

Re: git-scm.com

[Martin Langhoff]

On Mon, Jul 28, 2008 at 10:01 AM, Junio C Hamano <gitster@pobox.com> wrote:
> By the way, earlier Scott gave as explanation why he and others around
> GitHub, people who are not very visible on this list, are not interacting
> with us very much --- because they are not "C coders".

Well, I'm not a C coder either ;-) -- plenty of the large contributors
do their work in Perl Python and shell. Granted, I am not very active
lately, but that's because I'm busy on non-git-related (but
git-using!) projects.

And the choice of language has nothing to do with helping people
around. If they care about getting recommendations from list regulars,
anyway. Maintaining a great user-facing website might be their way of
engaging and interacting with us.

cheers,



martin
-- 
 martin.langhoff@gmail.com
 martin@laptop.org -- School Server Architect
 - ask interesting questions
 - don't get distracted with shiny stuff - working code first
 - http://wiki.laptop.org/go/User:Martinlanghoff

Re: git-scm.com

[Tom Werner]

On Sun, Jul 27, 2008 at 4:19 PM, Martin Langhoff
<martin.langhoff@gmail.com> wrote:
> And the choice of language has nothing to do with helping people
> around. If they care about getting recommendations from list regulars,
> anyway. Maintaining a great user-facing website might be their way of
> engaging and interacting with us.

As cofounder of GitHub I'd like to jump in and say a few words. I'm a
huge fan of git. HUGE. But that should already be obvious. We started
GitHub because we saw that git was a tremendously useful tool but was
missing a way to easily and flexibly share your public and private
code with other developers. That simple idea grew into what we now
like to call "Social Code Hosting."

I find it a bit confusing that some here seem to have a strong dislike
for GitHub. It's true that we haven't been active on the developer
list or in the #git channel on freenode, but we are constantly in
#github and have answered a *great* many questions from developers
that are new to git. At the same time, like Martin finally guesses, we
believe that our contribution to the git community is GitHub itself.
We provide free git hosting for over 16,000 open source repositories!
As mentioned earlier in the thread, the Ruby-Git binding that Scott
and I wrote has been open source from the beginning. While we did not
announce it here, we have publicized it in the Ruby circle (where,
presumably, people would most likely find it useful) and in fact there
are currently 28 forks and 138 watchers of the project. We've also
released albino, facebox, and github-services via GitHub. You can see
all the open source stuff we use at GitHub here:
http://github.com/github.


Perhaps it is the commercial aspect of GitHub that offends. The only
reason that GitHub is as featured and polished as it is, is because we
can make money from it. We hope to soon be working on GitHub full
time. There is no way this could have been possible if we did not
offer paid private repositories. A part of being a commercial
operation is making the main product closed source. One might argue
that we could still have GitHub as a service while making the code
open source, but the truth of the matter is that this is not in the
best interest of our future plans for the company.

I don't like the thought of being at odds with the git developer
community at all, and let me be the first to apologize if we've
offended anyone. It certainly is not our intention. Our goal with
GitHub is to help make git even better by offering a service that
helps people streamline their git workflows and discover projects that
may interest them. We're trying to give back to the community how we
know best: by offering kickass git hosting and associated
collaboration tools.

Having had to implement a git-daemon replacement that fit our needs, I
have some ideas on how to improve git-daemon and fetch-pack with
regards to error messages and logging. I'll be sure to bring those up
on this list. One thing you should probably understand about us is
that we're all about getting things done. Which is one reason we
weren't bothering everyone in here when we started GitHub. We like to
design from first principles, see how good we can do, and then get
feedback from the users. If you're a GitHub user (or have a reason why
you are *not* a GitHub user), we'd love to hear your feedback on ways
we can improve!

Tom Preston-Werner
github.com/mojombo

Re: git-scm.com

[Johannes Schindelin]

Hi,

On Sun, 27 Jul 2008, Tom Werner wrote:

> I find it a bit confusing that some here seem to have a strong dislike 
> for GitHub. It's true that we haven't been active on the developer list 
> or in the #git channel on freenode, but we are constantly in #github and 
> have answered a *great* many questions from developers that are new to 
> git.

Speaking for myself, I will probably direct some users from #git to 
#github, then.

The deeper reasoning: if you really do help by that channel, by all means 
I want to provide you with the opportunity to do so.

> As mentioned earlier in the thread, the Ruby-Git binding that Scott and 
> I wrote has been open source from the beginning. While we did not 
> announce it here, we have publicized it in the Ruby circle (where, 
> presumably, people would most likely find it useful) and in fact there 
> are currently 28 forks and 138 watchers of the project.

I find that limiting to the Ruby circle particularly unconvincing.  Sure, 
they might care much more than me.  Much more, to be sure.

But when _I_ -- being around the Git list for a long time -- do not _know_ 
about something like a pretty well-working Ruby-Git binding, instead only 
knowing a pretty stale effort on repo.or.cz by "corecode", then I think 
communication channels are suboptimal.  Way supoptimal.

Because at times _I_ am asked if there is some Git interface for Ruby, and 
it feels awkward that I am pretty familiar with Git's internals and 
community, yet I do not know about such an _important_ piece of software 
being available!

> Perhaps it is the commercial aspect of GitHub that offends.

In my opinion you can be as commercial as you want.  Nevertheless, I would 
like to see some direct benefit for me, too, for obvious reasons.  That 
does not need to be money; like Junio said, watching out for user 
questions on the Git list would already be very useful, in two respects:

- the core developers have more time for hacking on Git itself (which 
  would be good both for the developers as well as for you),

- if your advices can be enhanced (such as my gripe that "git show" is not 
  even so much as mentioned, in spite of being _the_ porcelain to inspect 
  objects in Git's object database, not cat-file, whose only role in 
  tutorials can be to shoo new users away) it will be early, which again 
  is a win-win situation for both core developers as well as for you, and

- just as in the past, I fully expect the main thrust of the major changes 
  in Git to be driven by user experience (just think of Git 1.5.0), and by 
  driving users away (and indeed, by driving yourself away, a bunch of 
  power-users), you would make that much more unlikely to happen in the 
  future.  So, having you closer to the Git mailing list and #git would
  again be a win-win situation.

> Having had to implement a git-daemon replacement that fit our needs, I
> have some ideas on how to improve git-daemon and fetch-pack with
> regards to error messages and logging.

I might mention here that I think you are committing one of the biggest 
sins in Open Source: you do not reap the full power of the community.

I am sure, if you would have mentioned your needs first, possibly followed 
by an early version of a patch, git-daemon would already be enhanced to 
your liking, and these enhancements would be available to everyone 
(including me, for example).  But maybe that being available to everyone 
is not in the best interest of a commercial outfit?

> We like to design from first principles, see how good we can do, and 
> then get feedback from the users.

Maybe this is so contrary to Open Source that many are uncomfortable with 
it.

Also note that one of the major gripe with you making money off of Git 
could be the following: we have over 500 contributors, and most of them -- 
first and foremost of all, the two major contributors, Junio and Shawn -- 
cannot make money from Git.  Envy is wrong, but it is real.

Do not get me wrong, I do not want to defend that behavior, but I think it 
is a reality that you will have to cope with.

Ciao,
Dscho

Re: git-scm.com

[Tom Werner]

On Mon, Jul 28, 2008 at 3:50 AM, Johannes Schindelin
<Johannes.Schindelin@gmx.de> wrote:
> On Sun, 27 Jul 2008, Tom Werner wrote:
>> I find it a bit confusing that some here seem to have a strong dislike
>> for GitHub. It's true that we haven't been active on the developer list
>> or in the #git channel on freenode, but we are constantly in #github and
>> have answered a *great* many questions from developers that are new to
>> git.
>
> Speaking for myself, I will probably direct some users from #git to
> #github, then.
>
> The deeper reasoning: if you really do help by that channel, by all means
> I want to provide you with the opportunity to do so.

By all means! The users might be a bit confused about why you're
sending them to #github, but we're happy to help them out if you don't
care to. We actually employ a support person to man the channel and
help out where he can.

>> Perhaps it is the commercial aspect of GitHub that offends.
>
> In my opinion you can be as commercial as you want.  Nevertheless, I would
> like to see some direct benefit for me, too, for obvious reasons.  That
> does not need to be money; like Junio said, watching out for user
> questions on the Git list would already be very useful, in two respects:
>
> - the core developers have more time for hacking on Git itself (which
>  would be good both for the developers as well as for you),

Using this same logic, it follows that we GitHub developers would be
better suited to hacking on GitHub (which would be good for the git
community). There are only so many hours in the day. I've had many a
GitHub user tell me that the GitHub interface and functionality helped
them finally understand git and feel comfortable switching to it from
SVN or CVS. It seems we can help bigger populations of git users by
making the site as clear and easy to use as possible, so that is what
we choose to do.

> - if your advices can be enhanced (such as my gripe that "git show" is not
>  even so much as mentioned, in spite of being _the_ porcelain to inspect
>  objects in Git's object database, not cat-file, whose only role in
>  tutorials can be to shoo new users away) it will be early, which again
>  is a win-win situation for both core developers as well as for you, and

Can you clarify what you are referring to here? I'm not sure I understand.

> - just as in the past, I fully expect the main thrust of the major changes
>  in Git to be driven by user experience (just think of Git 1.5.0), and by
>  driving users away (and indeed, by driving yourself away, a bunch of
>  power-users), you would make that much more unlikely to happen in the
>  future.  So, having you closer to the Git mailing list and #git would
>  again be a win-win situation.

I totally agree with the direction that 1.5 has taken git. You guys
are doing an awesome job with user experience. As I come across
usability problems I'll be sure to bring them up here in the future.

>> Having had to implement a git-daemon replacement that fit our needs, I
>> have some ideas on how to improve git-daemon and fetch-pack with
>> regards to error messages and logging.
>
> I might mention here that I think you are committing one of the biggest
> sins in Open Source: you do not reap the full power of the community.
>
> I am sure, if you would have mentioned your needs first, possibly followed
> by an early version of a patch, git-daemon would already be enhanced to
> your liking, and these enhancements would be available to everyone
> (including me, for example).  But maybe that being available to everyone
> is not in the best interest of a commercial outfit?

The problem is that I'm only a casual C coder. It takes me a while to
figure out what's going on in the git source. We needed a way to serve
public git repositories from a hashed directory structure (e.g.
/a/b/c/user/repo.git) and we needed it fast. In a few days worth of
coding Erlang, I was able to meet that need (and also add logging and
better error messages returned to the client). If I had, as you
suggest, created a badly written patch and asked for help on the list,
I'd probably still be trying to solve the problem. It's dubious that
anyone other than us currently needs to satisfy the hashed directory
requirement, and as such I would not assume or expect that anyone
would be motivated to spend a bunch of time helping a C amateur
satisfy that need. In the end I was responsible for making it work,
and I did that the best and most efficient way I knew how.

Like I said before, I'm happy to share my suggestions for better error
messages and logging behavior, but I'm probably not going to be much
help with providing patches.

>> We like to design from first principles, see how good we can do, and
>> then get feedback from the users.
>
> Maybe this is so contrary to Open Source that many are uncomfortable with
> it.
>
> Also note that one of the major gripe with you making money off of Git
> could be the following: we have over 500 contributors, and most of them --
> first and foremost of all, the two major contributors, Junio and Shawn --
> cannot make money from Git.  Envy is wrong, but it is real.

This is clearly false and does not do Junio or Shawn justice. It's not
hard to imagine that these two (or any of the other contributors)
could make money doing training for git at companies that have adopted
it, or as consultants to firms that use git in novel ways, or as
authors of git books. Scott Chacon gets paid right now to work on
tools that use git as an underlying file system. In fact, by helping
bring corporate interest to git, GitHub is paving the way for more and
more people to make money from git if they so choose. I wouldn't be
surprised if, down the road, Junio could be paid to hack on git full
time via corporate sponsorship. The continuing advancement of git is
of interest to a great many people. Some of which would gladly pay for
it.

Tom Preston-Werner
github.com/mojombo

Re: git-scm.com

[Junio C Hamano]

Johannes Schindelin <Johannes.Schindelin@gmx.de> writes:

> On Sun, 27 Jul 2008, Tom Werner wrote:
>
>> I find it a bit confusing that some here seem to have a strong dislike 
>> for GitHub. It's true that we haven't been active on the developer list 
>> or in the #git channel on freenode, but we are constantly in #github and 
>> have answered a *great* many questions from developers that are new to 
>> git.
>
> Speaking for myself, I will probably direct some users from #git to 
> #github, then.

I saw more than several times that people asked github specific questions
on #git; when they were lucky, there was somebody who knew github and they
got necessary help.  Otherwise the answer was "eh, sorry, that's a closed
service and we cannot help diagnosing the problem you are having".  It
would have been the right way to help them to refer to the #github support
channel.

If a company can fund somebody to help new users with git problems on #git
while helping people with github problems on #github, that would be a good
gesture towards the git community, I'd suppose.

> Also note that one of the major gripe with you making money off of Git 
> could be the following: we have over 500 contributors, and most of them -- 
> first and foremost of all, the two major contributors, Junio and Shawn -- 
> cannot make money from Git.  Envy is wrong, but it is real.

I do not talk for Shawn, but I think that comment misses the mark by a
large margin, at least for me.

I haven't been in this for money.  The original motivation of my
involvement was to help sending Linus back to the kernel as quickly as
possible, but now I primarily do this for fun.  Doing it for money would
risk removing the fun factor.

What I personally lack right now is time and mental bandwidth.

Active contributers of all kinds, ranging from "C coders", "scripters", to
"Documentation people" and "dropped patch naggers", have been helping me
quite a lot.  Corporate sponsors that can pay back in money but not in
patches may be able to find other ways to help us, but I do not offhand
know what's the most effective way for them to do so if they wanted to.

Re: git-scm.com

[Martin Langhoff]

On Tue, Jul 29, 2008 at 9:42 AM, Junio C Hamano <gitster@pobox.com> wrote:
> Active contributers of all kinds, ranging from "C coders", "scripters", to
> "Documentation people" and "dropped patch naggers", have been helping me
> quite a lot.  Corporate sponsors that can pay back in money but not in
> patches may be able to find other ways to help us, but I do not offhand
> know what's the most effective way for them to do so if they wanted to.

FWIW - not much probably - anything that pushes towards
"gui-completeness" is a good step.

We have fantastic gui tools that complement the awesome cli UI, and we
have some complete-ish GUIs, but the git-cheetah and Eclipse tracks
are lacking. Work on those is needed - whether money can help I do not
know. However, not many people work on polishing smooth UIs for love
and fun.

cheers,



martin
-- 
 martin.langhoff@gmail.com
 martin@laptop.org -- School Server Architect
 - ask interesting questions
 - don't get distracted with shiny stuff - working code first
 - http://wiki.laptop.org/go/User:Martinlanghoff

Re: git-scm.com

[Pieter de Bie]

On 28 jul 2008, at 23:42, Junio C Hamano wrote:

> Johannes Schindelin <Johannes.Schindelin@gmx.de> writes:
>
>> On Sun, 27 Jul 2008, Tom Werner wrote:
>>
>>> I find it a bit confusing that some here seem to have a strong  
>>> dislike
>>> for GitHub. It's true that we haven't been active on the developer  
>>> list
>>> or in the #git channel on freenode, but we are constantly in  
>>> #github and
>>> have answered a *great* many questions from developers that are  
>>> new to
>>> git.
>>
>> Speaking for myself, I will probably direct some users from #git to
>> #github, then.
>
> I saw more than several times that people asked github specific  
> questions
> on #git; when they were lucky, there was somebody who knew github  
> and they
> got necessary help.  Otherwise the answer was "eh, sorry, that's a  
> closed
> service and we cannot help diagnosing the problem you are having".  It
> would have been the right way to help them to refer to the #github  
> support
> channel.

For what it's worth, I regularly redirect people from #git to #github,  
so at
least they aren't always left in the dark ;)

- Pieter

Re: git-scm.com

[Shawn O. Pearce]

Junio C Hamano <gitster@pobox.com> wrote:
> Johannes Schindelin <Johannes.Schindelin@gmx.de> writes:
> > Also note that one of the major gripe with you making money off of Git 
> > could be the following: we have over 500 contributors, and most of them -- 
> > first and foremost of all, the two major contributors, Junio and Shawn -- 
> > cannot make money from Git.  Envy is wrong, but it is real.
> 
> I do not talk for Shawn, but I think that comment misses the mark by a
> large margin, at least for me.

I'm glad you guys think so highly of my contributions, but I am
only a small cog in the big machine known as "git".  I just happen
to like very-fine grained commits for any changes, which skews my
commit count upwards a bit.  There are _many_ contributors in that
"Primary Authors" list on git-scm.com who deserve attention too.  :)
 
> I haven't been in this for money.  The original motivation of my
> involvement was to help sending Linus back to the kernel as quickly as
> possible, but now I primarily do this for fun.  Doing it for money would
> risk removing the fun factor.
> 
> What I personally lack right now is time and mental bandwidth.

Well, here you could have spoken for me I think.  I do git because
I find it fun, rewarding, and challenging.  Though these days it
has been a little bit more work and a little bit less fun-challenge
as I am plowing through code for egit, but its a labor of love.

My contributions to Git are also about giving back, in return for
the benefit I have gained over the years from using Linux, and the
thousands of other open source packages that make it all work.
I'm not big on kernel hacking (though I did try it for about 6
months) so this is one way I can put a few pennys back in the open
source take-a-penny/leave-a-penny penny jar.

More recently I may be in a position where my new employer might
be able to make some contribution to the community through part of
my time.  I shall see if it winds up detracting from the fun aspect
of it for me.  Personally I tend to get so focused on something that
I have a very hard time moving away from it, and just want to focus
on that one thing and do it well.  Doing it at day-job may make
that easier, and reduce stress on me, in turn making it more fun.

> [...] Corporate sponsors that can pay back in money but not in
> patches may be able to find other ways to help us, but I do not offhand
> know what's the most effective way for them to do so if they wanted to.

I don't know how much kernel.org needs support, but we rely heavily
on kernel.org for our main distribution site of git.  Its a drop
in the bucket compared to the Linux kernel activity itself, but I
imagine that the right sort of Linux-friendly (and Git-friendly)
corporate sponsor could really help kernel.org out.  Of course only
so much help is really useful, and I have no idea what kernel.org's
financial (and staff time) situtation is like, so I'll shut up now.

Pasky's repo.or.cz is another huge area that the community relies
upon.  Fortunately Pasky has been able to offer its services freely,
but in the future it may reach a point where corporate support
for adminstration assitance, duct-tape development, bandwidth or
hardware, may be extremely beneficial.

-- 
Shawn.

Re: git-scm.com

[Jon Loeliger]

Tom Werner wrote:
>
> The problem is that I'm only a casual C coder. It takes me a while to
> figure out what's going on in the git source. We needed a way to serve
> public git repositories from a hashed directory structure (e.g.
> /a/b/c/user/repo.git) and we needed it fast. 

I'm not exactly sure what you mean by "hashed directory structure",
but I suspect that your goal is some form of virtualized hosting
that allows for directory names to be dynamically constructed with
a component that appears to be the user name.

Wouldn't the --interpolated-path ability of git-daemon either
directly or with minor modifications directly support that?

jdl

Re: git-scm.com

[Kevin Ballard]

On Jul 31, 2008, at 11:39 AM, Jon Loeliger wrote:

> Tom Werner wrote:
>>
>> The problem is that I'm only a casual C coder. It takes me a while to
>> figure out what's going on in the git source. We needed a way to  
>> serve
>> public git repositories from a hashed directory structure (e.g.
>> /a/b/c/user/repo.git) and we needed it fast.
>
> I'm not exactly sure what you mean by "hashed directory structure",
> but I suspect that your goal is some form of virtualized hosting
> that allows for directory names to be dynamically constructed with
> a component that appears to be the user name.
>
> Wouldn't the --interpolated-path ability of git-daemon either
> directly or with minor modifications directly support that?

Tom, correct me if I'm wrong, but my understanding of this is that,  
with GFS, they were running into the problem of too many dirents in  
one directory, thus causing lots of stability problems (GFS has a far  
lower limit than other filesystems in this regard). So the GitHub guys  
had to switch to a directory sharding structure (similar to how the  
git objects db uses the first 2 characters of the hash as the dir  
name) to split this up and keep the numbers manageable. However, they  
still had to support the old git://github.com/user/project.git paths.

-Kevin Ballard

-- 
Kevin Ballard
http://kevin.sb.org
kevin@sb.org
http://www.tildesoft.com

git-scm.com (was Re: Git graph on GitHub)

[PJ Hyett]

> One nitpick regarding your git.git mirror: I doubt that people here
> ("the community") consider git-scm.com to be "the git homepage". I don't
> want to go into the reasons and start a pointless thread, but since
> git-scm.com is a fork of git.or.cz pointing to the latter (the root)
> should make everyone happy.

Hi Michael,
I'll go ahead and start a pointless thread along with the reasons
provided via answers to the 2008 Git Survey[1]:

43) What could be improved on the Git homepage(s)?

* Use git-scm.com instead of git.or.cz as the default homepage
* Learn from git-scm.com. Make it more newbie-friendly. More focus on
documentation
* Better graphical design/organization - new(?) git-scm.com looks better
* Look at git-scm.com :)
* Cleaner design, better organization (http://git-scm.com/ is a good start).
* Design - git-scm.com is superior compared to git.or.cz. Also the
first one is more user-friendly having exposed more important things
for users rather for experienced veterans who want to download most
current git release.
* I like what Scott Chacon has done with http://git-scm.com
* I prefer Scot Chacons rewrite, but mostly just it's look and feel.
The original site is perfectly functional; though it could do with
better documentation.
* git-scm.com
* git-scm.com is a great example of some light improvement. I do think
that the online man-page navigation is a little annoying, having to
revert to find in the browser to get to the right spot on the page. An
alternate alphabetical listing might help.
* Don't put everything on the first page, it is a little confusing.
Create categories, like download, documentation, About git and at
least a dedicated page for each of these categories. I think the
"design" could also be improved. I saw a proposition not long ago
aboutr a new git homepage on the mailing list: www.git-scm.com. I
think this site is easier to navigate and thus makes it easier to find
informations.
* I like the new git-scm site (with the blob committed to storing trees)
* Merge with Git-scm page?
* I like <http://www.git-scm.com> very much. I'd vote for it to be the
official Git homepage.
* git.or.cz?? I prefer http://git-scm.com/, it's better for beginners,
and the information is nicely presented (doc, tips, videos..).
* promote git-scm.com instead of git.or.cz
* See http://git-scm.com/
* I think git-scm.com is starting to get things right. Making
documentation readily available especially.
* Complete re-design by somebody actually the least bit proficient in
design? Oh wait, that's already been done at http://git-scm.com/.
* Rather ugly design. git-scm.com looks much better.
* I like Scott Chacon's site a lot and use it often: http://git-scm.com/
* Compare #1 and #2 1) http://git-scm.com 2) http://git.or.cz
* http://git.or.cz and http://git-scm.com should be merged
* http://git-scm.com/ is a worderfull project, making the homepage
look and feel much better and "user friendly". The source code is at
http://github.com/schacon/gitscm. What about using this as the Git
official homepage (not the domain, but the interface and images).
* git-scm.com should be the official page :)
* Organization and flow particularly for new users. I think Scott
Chacon's git-scm.com site does a much better job. Organization and
navigation of the content are the things that make it a winner.
* The www.git-scm.com homepage is great.
* Which one? http://git.or.cz/ or http://git-scm.com/ I tend to use
git-scm.com just because it looks nicer, is written in Rails and has
more user friendly information. Rather than browsing what feels like
"A manual online" that is git.or.cz
* I think the homepage (http://git-scm.com/) however work should be
done to have that come ahead of http://git.or.cz/ which currently tops
all the queries. I would try to strike a deal with that domain to
http-redirect to the new url. I can only imagine that this duplication
leads to confusion and a bad experience.
* It should look more like http://git-scm.com
* http://git-scm.com/ > git.or.cz -scm has all the info I might want
up front in one page, while my eyes gloss over just looking at or.cz.

Cheers,
PJ Hyett
http://github.com/pjhyett

1. http://www.survs.com/app/4/wo/IQ2m9AwQ2qFAVwuZrRLF4w/0.0.9.3.3.0.1.3.42.1.7.1

Re: git-scm.com (was Re: Git graph on GitHub)

[Wincent Colaiuta]

El 15/10/2008, a las 12:18, PJ Hyett escribió:

>> One nitpick regarding your git.git mirror: I doubt that people here
>> ("the community") consider git-scm.com to be "the git homepage". I  
>> don't
>> want to go into the reasons and start a pointless thread, but since
>> git-scm.com is a fork of git.or.cz pointing to the latter (the root)
>> should make everyone happy.
>
> Hi Michael,
> I'll go ahead and start a pointless thread along with the reasons
> provided via answers to the 2008 Git Survey[1]:

Coming up in news at 6...

GitHub announces new maintainer for Git

GitHub is proud to announce the replacement of the old Git maintainer  
with the "Git Core Team", comprising PJ Hyett, Scott Chacon, Tom  
Preston and some select personalities from the Ruby on Rails world.  
You'll be able to track all the latest updates to "Git Edge" over at  
GitHub. The former maintainer, Junio C Hamano, is being retired from  
service because the Git community (see git-scm.com) decided he wasn't  
as good-looking as David Heinemeier Hanson. For more information, see  
the official Git book (book.git-scm.com).

Re: git-scm.com (was Re: Git graph on GitHub)

[Scott Chacon]

Hi,

On Wed, Oct 15, 2008 at 3:34 AM, Wincent Colaiuta <win@wincent.com> wrote:
> El 15/10/2008, a las 12:18, PJ Hyett escribió:
>
>>> One nitpick regarding your git.git mirror: I doubt that people here
>>> ("the community") consider git-scm.com to be "the git homepage". I don't
>>> want to go into the reasons and start a pointless thread, but since
>>> git-scm.com is a fork of git.or.cz pointing to the latter (the root)
>>> should make everyone happy.

There is a slight misperception here.  I setup the git mirror at
GitHub as part of my git-scm.com work, they did not do it as some sort
of semi-official mirror.  The reason the git.git repo points to
git-scm is because I had plans to use github apis to do some fun stuff
on git-scm, and the mirror is being kept up to date by scripts on the
git-scm server.  Also, I figured it was likely that people looking at
the git repo on GitHub rather than on kernel.org would probably be
more interested in the more user-friendly version, yes?  That's all,
it's nothing sinister. Petr and I have previously discussed trying to
unify the sites somehow and will likely discuss this in more detail at
the GitTogether in a few weeks.

Also, trust me - none of us want Junio's job.  I've talked way too
much with Shawn over the last few weeks to ever covet that position :)

I do wish that there wasn't this 'us vs them' mentality on this list,
though. I think GitHub is doing some good things for the community,
and I also think that 'the community' is bigger than this list.  I
propose that we spend our cycles on git stuff, rather than mocking or
trying to exclude each other.

Also, I think we can all agree that Junio is strikingly handsome.

Scott

>>
>> Hi Michael,
>> I'll go ahead and start a pointless thread along with the reasons
>> provided via answers to the 2008 Git Survey[1]:
>
> Coming up in news at 6...
>
> GitHub announces new maintainer for Git
>
> GitHub is proud to announce the replacement of the old Git maintainer with
> the "Git Core Team", comprising PJ Hyett, Scott Chacon, Tom Preston and some
> select personalities from the Ruby on Rails world. You'll be able to track
> all the latest updates to "Git Edge" over at GitHub. The former maintainer,
> Junio C Hamano, is being retired from service because the Git community (see
> git-scm.com) decided he wasn't as good-looking as David Heinemeier Hanson.
> For more information, see the official Git book (book.git-scm.com).
>
> --
> To unsubscribe from this list: send the line "unsubscribe git" in
> the body of a message to majordomo@vger.kernel.org
> More majordomo info at  http://vger.kernel.org/majordomo-info.html
>

Re: git-scm.com (was Re: Git graph on GitHub)

[Petr Baudis]

On Wed, Oct 15, 2008 at 09:21:50AM -0700, Scott Chacon wrote:
> Petr and I have previously discussed trying to unify the sites somehow
> and will likely discuss this in more detail at the GitTogether in a
> few weeks.

Yes. I mentioned this on IRC but should really write it on the mailing
list - I'm looking forward for the GitTogether to resolve any remaining
issues anyone has with git-scm.com and make git.or.cz probably
essentially point to git-scm.com. Since the old threads died away long
ago, if anyone - especially who is not attending GitTogether - still
dislikes some things about the git-scm.com site, please follow up here.

> I do wish that there wasn't this 'us vs them' mentality on this list,
> though. I think GitHub is doing some good things for the community,
> and I also think that 'the community' is bigger than this list.

I think this last sentence is where we differ - for (most of?) us the
Git developers, 'the community' pretty much _is_ this list (with the IRC
channel as its casual extension). But I'm very glad to see an
announcement from the GitHub people here and I hope we will see more of
them. Don't worry about the occasional flames, we all get hit by them
sometime. :-) (Um, I personally think *I* get flamed much less than I
would deserve. ;-)

-- 
				Petr "Pasky" Baudis
People who take cold baths never have rheumatism, but they have
cold baths.

Re: git-scm.com (was Re: Git graph on GitHub)

[PJ Hyett]

> Coming up in news at 6...
>
> GitHub announces new maintainer for Git
>
> GitHub is proud to announce the replacement of the old Git maintainer with
> the "Git Core Team", comprising PJ Hyett, Scott Chacon, Tom Preston and some
> select personalities from the Ruby on Rails world. You'll be able to track
> all the latest updates to "Git Edge" over at GitHub. The former maintainer,
> Junio C Hamano, is being retired from service because the Git community (see
> git-scm.com) decided he wasn't as good-looking as David Heinemeier Hanson.
> For more information, see the official Git book (book.git-scm.com).

In case there was any confusion, this is why we almost never bother
posting to the list, because no matter what the topic, it always turns
into why the git community hates GitHub.

I really don't understand the disdain for a company that's made git
accessible to a much wider audience in less than a year. I kinda
thought we'd all be on the same team.

For the record, Scott wasn't a GitHub employee when he wrote
git-scm.com, nor was he paid to produce it. Turns out people don't
always have ulterior motives, he just wanted to make a better git
homepage.


-PJ

Re: git-scm.com (was Re: Git graph on GitHub)

[Jonathan del Strother]

On Wed, Oct 15, 2008 at 7:36 PM, PJ Hyett <pjhyett@gmail.com> wrote:
>> Coming up in news at 6...
>>
>> GitHub announces new maintainer for Git
>>
>> GitHub is proud to announce the replacement of the old Git maintainer with
>> the "Git Core Team", comprising PJ Hyett, Scott Chacon, Tom Preston and some
>> select personalities from the Ruby on Rails world. You'll be able to track
>> all the latest updates to "Git Edge" over at GitHub. The former maintainer,
>> Junio C Hamano, is being retired from service because the Git community (see
>> git-scm.com) decided he wasn't as good-looking as David Heinemeier Hanson.
>> For more information, see the official Git book (book.git-scm.com).
>
> In case there was any confusion, this is why we almost never bother
> posting to the list, because no matter what the topic, it always turns
> into why the git community hates GitHub.

Really?  I thought it was usually just about how Wincent hates GitHub.


FWIW, I think github is pretty good, and git-scm.com is great.

Re: git-scm.com (was Re: Git graph on GitHub)

[Jakub Narebski]

"PJ Hyett" <pjhyett@gmail.com> writes:

[> Wincent Colaiuta wrote:]
The above attribution was missing, BTW...

> > Coming up in news at 6...
> >
> > GitHub announces new maintainer for Git
> >
> > GitHub is proud to announce the replacement of the old Git maintainer with
> > the "Git Core Team", comprising PJ Hyett, Scott Chacon, Tom Preston and some
> > select personalities from the Ruby on Rails world. You'll be able to track
> > all the latest updates to "Git Edge" over at GitHub. The former maintainer,
> > Junio C Hamano, is being retired from service because the Git community (see
> > git-scm.com) decided he wasn't as good-looking as David Heinemeier Hanson.
> > For more information, see the official Git book (book.git-scm.com).
> 
> In case there was any confusion, this is why we almost never bother
> posting to the list, because no matter what the topic, it always turns
> into why the git community hates GitHub.

Errr... for me it looks like somebodys irony detection is not working...
On the other hand it is why Scott E Fahlman invented emoticons :-)

-- 
Jakub Narebski
Poland
ShadeHawk on #git

Re: git-scm.com

[Teemu Likonen]

PJ Hyett [2008-10-15 11:36 -0700]:

> For the record, Scott wasn't a GitHub employee when he wrote
> git-scm.com, nor was he paid to produce it. Turns out people don't
> always have ulterior motives, he just wanted to make a better git
> homepage.

I'm not sure what community I'm part of but I think git-scm.com is much
better homepage. I also think that the new user book[1] is better than
the one in kernel.org. So thanks for contributing to git users.

-------------
1. http://book.git-scm.com/

Re: git-scm.com (was Re: Git graph on GitHub)

[Garry Dolley]

On Wed, Oct 15, 2008 at 11:36:10AM -0700, PJ Hyett wrote:
> > Coming up in news at 6...
> >
> > GitHub announces new maintainer for Git
> >
> > GitHub is proud to announce the replacement of the old Git maintainer with
> > the "Git Core Team", comprising PJ Hyett, Scott Chacon, Tom Preston and some
> > select personalities from the Ruby on Rails world. You'll be able to track
> > all the latest updates to "Git Edge" over at GitHub. The former maintainer,
> > Junio C Hamano, is being retired from service because the Git community (see
> > git-scm.com) decided he wasn't as good-looking as David Heinemeier Hanson.
> > For more information, see the official Git book (book.git-scm.com).
> 
> In case there was any confusion, this is why we almost never bother
> posting to the list, because no matter what the topic, it always turns
> into why the git community hates GitHub.

For the record, I'm a part of the git community and I like GitHub
quite a bit. :)

-- 
Garry Dolley
ARP Networks, Inc.
http://scie.nti.st
Los Angeles County REACT, Unit 336
WQGK336

Re: git-scm.com (was Re: Git graph on GitHub)

[Aaron Cohen]

On Wed, Oct 15, 2008 at 4:12 PM, Garry Dolley <gdolley@arpnetworks.com> wrote:
> On Wed, Oct 15, 2008 at 11:36:10AM -0700, PJ Hyett wrote:
>> > Coming up in news at 6...
>> >
>> > GitHub announces new maintainer for Git
>> >
>> > GitHub is proud to announce the replacement of the old Git maintainer with
>> > the "Git Core Team", comprising PJ Hyett, Scott Chacon, Tom Preston and some
>> > select personalities from the Ruby on Rails world. You'll be able to track
>> > all the latest updates to "Git Edge" over at GitHub. The former maintainer,
>> > Junio C Hamano, is being retired from service because the Git community (see
>> > git-scm.com) decided he wasn't as good-looking as David Heinemeier Hanson.
>> > For more information, see the official Git book (book.git-scm.com).
>>
>> In case there was any confusion, this is why we almost never bother
>> posting to the list, because no matter what the topic, it always turns
>> into why the git community hates GitHub.
>
> For the record, I'm a part of the git community and I like GitHub
> quite a bit. :)
>

For the record, I'm not part of either community and find things to
dislike about both of them.

git.or.cz: I personally prefer its plain style, but it has way too
much information on the front page (why is so much download
information on that page rather than hidden behind the "download" link
that currently just goes to an ftp directory?)

git-scm.com: Much better organized, but suffers from web 2.0
shininess.  Also, every time I look at it my eyes have to read
EVERYTHING to figure out what ANYTHING is.  For instance, why is there
that random column of "projects using git" that seems to only exist to
distract me from the important stuff?

Re: git-scm.com

[Nanako Shiraishi]

Quoting Petr Baudis <pasky@suse.cz>:
> On Wed, Oct 15, 2008 at 09:21:50AM -0700, Scott Chacon wrote:
>> I do wish that there wasn't this 'us vs them' mentality on this list,
>> though. I think GitHub is doing some good things for the community,
>> and I also think that 'the community' is bigger than this list.
>
> I think this last sentence is where we differ - for (most of?) us the
> Git developers, 'the community' pretty much _is_ this list (with the IRC
> channel as its casual extension).

Curiously, whenever somebody says "git-scm.com is the official git homepage", you are not involved in the discussion.  Could you share your position on this issue with the rest of the "community"?

-- 
Nanako Shiraishi
http://ivory.ap.teacup.com/nanako3/

Re: git-scm.com

[Petr Baudis]

On Thu, Oct 16, 2008 at 06:42:39PM +0900, Nanako Shiraishi wrote:
> Quoting Petr Baudis <pasky@suse.cz>:
> > On Wed, Oct 15, 2008 at 09:21:50AM -0700, Scott Chacon wrote:
> >> I do wish that there wasn't this 'us vs them' mentality on this list,
> >> though. I think GitHub is doing some good things for the community,
> >> and I also think that 'the community' is bigger than this list.
> >
> > I think this last sentence is where we differ - for (most of?) us the
> > Git developers, 'the community' pretty much _is_ this list (with the IRC
> > channel as its casual extension).
> 
> Curiously, whenever somebody says "git-scm.com is the official git homepage", you are not involved in the discussion.  Could you share your position on this issue with the rest of the "community"?

  To possibly save Junio some archives digging, he did share his
position in the original thread at

	http://thread.gmane.org/gmane.comp.version-control.git/90079/focus=90167

				Petr "Pasky" Baudis

Re: git-scm.com

[Junio C Hamano]

Nanako Shiraishi <nanako3@lavabit.com> writes:

> Quoting Petr Baudis <pasky@suse.cz>:
>> On Wed, Oct 15, 2008 at 09:21:50AM -0700, Scott Chacon wrote:
>>> I do wish that there wasn't this 'us vs them' mentality on this list,
>>> though. I think GitHub is doing some good things for the community,
>>> and I also think that 'the community' is bigger than this list.
>>
>> I think this last sentence is where we differ - for (most of?) us the
>> Git developers, 'the community' pretty much _is_ this list (with the IRC
>> channel as its casual extension).
>
> Curiously, whenever somebody says "git-scm.com is the official git
> homepage", you are not involved in the discussion.  Could you share your
> position on this issue with the rest of the "community"?

The thing is, I do not think whatever I say would be any more official
than what Pasky says when it comes to "the git homepage", even though I
might be a fairly central person in the developer community.

I first have to say that in this era of the Internet and distributed
development, "official" status means much less than what everybody seems
to think [*1*].  It is perfectly fine for people to decide which site they
would want to go for git related information for themselves, and direct
their friends to.

In other words, I do not care either way very much, personally.

The "official" maintainer of git was Shawn for a short while last year in
October, after he claimed to act as one during my absense, and everybody
accepted it not because I named him but he had the necessary respect and
trust from the developers.  I asked him to be the maintainer again this
year during early October, and again it worked quite well.  I imagine it
would have worked if it were not Shawn but any other people among the few
people I trust on this list.  I don't have to name them but you know who
you are, and more importantly, people in the developer community know who
you are.  That is what respect and trust are about.

It wouldn't have worked well if the self-claimed interim maintainer were
just some random Joe, and it wouldn't have worked well either, even if I
endorsed him, if the random Joe did not have enough respect and trust from
the community.

Pasky's site came first from very early in git's life, people contributed
contents to it over time, and he kept the site up-to-date, and through all
that effort, Pasky earned (at least my) respect and trust that the site
will keep serving the git users and developers well as it has been in the
past.  For this reason, to me personally, the "official homepage" has
always been git.or.cz, and will continue to be so, until Pasky says he
considers Scott and his pages earned enough respect and trust _from him_,
and wants to redirect git.or.cz traffic to git-scm.com [*2*].

Regarding "the community", I think what Pasky said in the quoted message
is right in that the word, used in a message on _this_ mailing list,
refers to "the developer community", whose definition I 100% agree with
what he said.

I sense that people around GitHub come from a different world --- it may
also be a legitimate "git community" (perhaps a "users and evangelists
community", which is not a bad thing in itself), but certainly it is
different from the git developer community as I know it.

I think "us vs them" mentality is unavoidable to a certain degree.  More
importantly, I should also point out that it goes both ways.  I think the
"fork once and part forever" attitude of git-scm.com from the very
beginning stems from the very same "us vs them" mentality.  The developer
community ("them" for Scott, "us" for me and Pasky) has been (and will
always be) text oriented, because we tend to try shooting for the greatest
common denominator.  The end-user community in this Web 2.0 era ("us" for
Scott, "them" for me and Pasky) on the other hand, would want to be
entertained by singing and dancing contents.  The two communities serve
different purposes and consist of different audiences.

Very early on, Scott made his intention clear that git-scm.com once copies
from git.or.cz, forks and is very unlikely to merge back because of this
vast difference of the target audience.  That's "us vs them" mentality
right there, but I do not think this division was particularly a bad thing
at all.  It led to what git-scm.com site has in addition to what it copied
from git.or.cz; git-scm.com has made git more approachable by the kinds of
end users who were repelled by the spartan git.or.cz's contents and
organization.  It was a good thing.

So let's help both sites improve support for git users _and_ developers,
and watch git-scm.com continue earning our respect and trust.  It is my
understanding that Pasky is hoping that it can turn into a good site that
supports not just end users but developers well, so that he can start
redirecting repo.or.cz traffic to it, and I am hoping the same.

And let's do so without flaming anybody ;-).


[Footnote]

*1* While I was researching to write this message, I was kind of surprised
to find that the Wikipedia article on git went through a few rounds of
flipping between pointing at git.or.cz and git-scm.com.  I didn't study
the page history deeply enough to see who did what change, but I doubt any
of the people who are doing real work on either site are stupid enough to
have got involved in the self promotion nonsense.  I trust Pasky that much
(and much more), and also I came to trust Scott at least that much, after
seeing git-scm.com adding useful contents over the past few months
(admittedly the rate of the improvement may have slowed down somewhat
recently, compared to its initial bulk import from git.or.cz).

*2* There is no point in duplicated effort when the goals of two sites are
compatible and when there is such trust between two parties.  I do not yet
know if the goals are compatible, though.  We'll see.