Re: git-scm.com website

From: Michael J Gruber <git@drmicha.warpmail.net>
Date: Mar 10, 2015, 09:07 UTC
Message-ID: <54FEB45B.3020601@drmicha.warpmail.net>
In-Reply-To: <CAP2yMa+Bw0KCSz9YEtviZUykAp4jpdsEWSK-jRxtd9MjzjHKfg@mail.gmail.com>

Scott Chacon venit, vidit, dixit 09.03.2015 18:14:

Show 31 quoted lines

> Hey,
> 
> On Mon, Mar 9, 2015 at 9:06 AM, David Kastrup <dak@gnu.org> wrote:
>>> On Mon, Mar 9, 2015 at 6:57 AM, Michael J Gruber
>>> <git@drmicha.warpmail.net> wrote:
>>>>
>>>> Since we're talking business: git-scm.com still looks a bit like a
>>>> ProGit/Github promotion site. I don't have anything against either, and
>>>> git-scm.com provides a lot of the information that users are looking
>>>> for, and that are hard to find anywhere else; it's a landing page. It
>>>> just does not look like a "project home".
> 
> I'm sorry that you feel this way, but I've tried pretty hard to make
> sure the site is as neutral as possible. The only actual place the
> string "GitHub" occurs on the landing page is at the bottom where it
> says "This open sourced site is hosted on GitHub."  I don't even
> mention anywhere that GitHub pays for hosting it. Also, all the Amazon
> referrals from Pro Git sales are donated to the Software Freedom
> Conservancy and all my personal royalties are donated to charity. It
> also very clearly states that the book is free to read online in it's
> entirety (which is actually relatively expensive for me personally,
> since I personally pay the S3 hosting and bandwidth costs for all the
> eBook downloads).
> 
> I'm not sure why you think it doesn't look like a "project home". It
> has basically all the same information on it that you would find on
> any other project home page: a description, direct links to downloads,
> source code, documentation, a book, community and development
> information, etc. These are basically all the same things found on
> sites like http://www.gnu.org/software/emacs/ or
> https://subversion.apache.org/.

Since quotes from several people got put together here and below (which I cut out), I'd just like to reemphasize that I "don't have anything against either", as I wrote. Github has done a lot to promote Git - as a business, sure, but why not, and Git as a project has profited from that, too. It goes without saying that stating "Hosted on Github" is appropriate, not just because git-scm.com is hosted there, but because it shows what kind of services Git empowers. And I don't mind a listing of companies that use Git - it's not an endorsement of those companies, rather the other way round. (I hope it's legally OK to use their names and logos for that, I'm not a laywer, but I'm confident you've checked.)

"This is the web application for the git-scm.com site. It is meant to be the first place a person new to Git will land and download or learn about the Git SCM system." says the README, and that's what the site is. A landing page for people new to Git. It's good that we have one.

Maybe my use of the term "project home" was misleading. What I meant is: it's not a home *for* the developer community. That's just a factual statement without assigning blame. For example, Documentation/technical is not linked there, and the blog doesn't carry release announcements or Junio's technical posts. Development discussions take place on the mailing list, and when we talk about user experience, it's UI and man pages that we have in mind, not git-scm.com. When we need a web page for GSoC or such, it's "something on github" that at least mentally is not part of git-scm.com.

Now, unfortunately, git-scm.com is also not *from* the developer community, if you define "developer := git ml regular" (and not := mostly not) and look at https://github.com/git/git-scm.com/graphs/contributors. There's probably no point in going into the historical reasons for that - after all, we're not all German ;)

Seriously, I think "we" could try to put more stuff on git-scm.com. Having GSoC and microprojects stuff ported there would be nice, I guess that would require someone who knows a bit about the underlying web app to get the framework right.

Maybe there's a painless way to get release announcements or similar posts on the blog, so that there is more visible activity? Or collect some external blogs?

I'm a no-ruby-no-rails guy, sorry, but I'll commit at least to looking over some content especially in the man page/documentation area.

Michael