git / git-scm.com

The git-scm.com website. Note that this repository is only for the website; issues with git itself should go to https://git-scm.com/community.

Git - fast, scalable, distributed revision control system

Git is a fast, scalable, distributed revision control system with an unusually rich command set that provides both high-level operations and full access to internals.

Git is an Open Source project covered by the GNU General Public License version 2 (some parts of it are under different licenses, compatible with the GPLv2). It was originally written by Linus Torvalds with help of a group of hackers around the net.

Please read the file INSTALL for installation instructions.

Many Git online resources are accessible from https://git-scm.com/ including full documentation and Git related tools.

See Documentation/gittutorial.txt to get started, then see Documentation/giteveryday.txt for a useful minimum set of commands, and Documentation/git-<commandname>.txt for documentation of each command. If git has been correctly installed, then the tutorial can also be read with man gittutorial or git help tutorial, and the documentation of each command with man git-<commandname> or git help <commandname>.

CVS users may also want to read Documentation/gitcvs-migration.txt (man gitcvs-migration or git help cvs-migration if git is installed).

The user discussion and development of Git take place on the Git mailing list -- everyone is welcome to post bug reports, feature requests, comments and patches to [email protected] (read Documentation/SubmittingPatches for instructions on patch submission and Documentation/CodingGuidelines).

Those wishing to help with error message, usage and informational message string translations (localization l10) should see po/README.md (a po file is a Portable Object file that holds the translations).

To subscribe to the list, send an email to [email protected] (see https://subspace.kernel.org/subscribing.html for details). The mailing list archives are available at https://lore.kernel.org/git/, https://marc.info/?l=git and other archival sites.

Issues which are security relevant should be disclosed privately to the Git Security mailing list [email protected].

The maintainer frequently sends the "What's cooking" reports that list the current status of various development topics to the mailing list. The discussion following them give a good reference for project status, development direction and remaining tasks.

The name "git" was given by Linus Torvalds when he wrote the very first version. He described the tool as "the stupid content tracker" and the name as (depending on your mood):

• random three-letter combination that is pronounceable, and not actually used by any common UNIX command. The fact that it is a mispronunciation of "get" may or may not be relevant.
• stupid. contemptible and despicable. simple. Take your pick from the dictionary of slang.
• "global information tracker": you're in a good mood, and it actually works for you. Angels sing, and a light suddenly fills the room.
• "goddamn idiotic truckload of sh*t": when it breaks

git-scm.com's Issues

blog

we should have a blog - detailing new releases and what's in them, as well as pointing out interesting things in the git community

incorporate whygitisbetterthanx content

all the wgibtx content should be in git-scm, except remove the comparisons to the other dvcs systems and concentrate on the advantages of git over clearcase, perforce, svn

mailing list browser

gmane is just goddamn awful.

have a sane email list interface for the git ML that is searchable through git-scm, filterable, permalinkable and possibly postable (perhaps authing through google or github)

Multiple "Note" blocks run together on git-fetch page

http://git-scm.com/docs/git-fetch

Under the description of <refspec> in the OPTIONS section, it appears that what should be three individual Notes are run together.

update current version/man-page content via github api

poll the github git mirror git/git for new versions, add new versions and update which is the latest, then find man-page changes and store and index them

[UI issue] Book unintuitive to navigate after new layout

The book (documentation) references chapters in many instances, but I cannot see what chapter or sub-chapter I am on, nor can I navigate to sub-chapters.

In short:

• Chapters and sub-chapter numbers not easily visible (in the URL or on the page; javascript, for example).
• No navigation menu for sub-chapters; Can only use 'prev' and 'next' buttons at the bottom of a page.

git urls on clone page should be bullets

If you look under "Git URLs" here:

http://git-scm.herokuapp.com/ref/git-clone

There are a bunch of url examples that are in a paragraph rather than bullets

rake preindex failing on heroku

v1.7.7.7
v1.7.7.7: 2012-04-26 16:41:52 +0000, 82588584, 913a5cb6
Found 163 entries
Connected to NewRelic Service at collector-1.newrelic.com:80
rake aborted!
can't convert nil into String
/app/lib/asciidoc.rb:278:in `+'
/app/lib/asciidoc.rb:278:in `block in htmlify'
/app/lib/asciidoc.rb:278:in `gsub!'
/app/lib/asciidoc.rb:278:in `htmlify'
/app/lib/asciidoc.rb:249:in `block in content'
/app/lib/asciidoc.rb:249:in `map'
/app/lib/asciidoc.rb:249:in `content'
/app/templates/section_paragraph.html.erb:4:in `block in singletonclass'
/app/templates/section_paragraph.html.erb:65533:in `instance_eval'
/app/templates/section_paragraph.html.erb:65533:in `singletonclass'
/app/templates/section_paragraph.html.erb:65531:in `__tilt_4866620'
/app/vendor/bundle/ruby/1.9.1/gems/tilt-1.3.3/lib/tilt/template.rb:140:in `call'
/app/vendor/bundle/ruby/1.9.1/gems/tilt-1.3.3/lib/tilt/template.rb:140:in `cached_evaluate'
/app/vendor/bundle/ruby/1.9.1/gems/tilt-1.3.3/lib/tilt/template.rb:127:in `evaluate'
/app/vendor/bundle/ruby/1.9.1/gems/tilt-1.3.3/lib/tilt/template.rb:76:in `render'
/app/lib/asciidoc.rb:95:in `render'
/app/lib/asciidoc.rb:198:in `render'
/app/lib/asciidoc.rb:424:in `block in content'
/app/lib/asciidoc.rb:424:in `map'
/app/lib/asciidoc.rb:424:in `content'
/app/templates/section.html.erb:12:in `block in singletonclass'
/app/templates/section.html.erb:65533:in `instance_eval'
/app/templates/section.html.erb:65533:in `singletonclass'
/app/templates/section.html.erb:65531:in `__tilt_4866620'
/app/vendor/bundle/ruby/1.9.1/gems/tilt-1.3.3/lib/tilt/template.rb:140:in `call'
/app/vendor/bundle/ruby/1.9.1/gems/tilt-1.3.3/lib/tilt/template.rb:140:in `cached_evaluate'
/app/vendor/bundle/ruby/1.9.1/gems/tilt-1.3.3/lib/tilt/template.rb:127:in `evaluate'
/app/vendor/bundle/ruby/1.9.1/gems/tilt-1.3.3/lib/tilt/template.rb:76:in `render'
/app/lib/asciidoc.rb:95:in `render'
/app/lib/asciidoc.rb:410:in `render'
/app/lib/asciidoc.rb:424:in `block in content'
/app/lib/asciidoc.rb:424:in `map'
/app/lib/asciidoc.rb:424:in `content'
/app/templates/document.html.erb:16:in `evaluate_source'
/app/vendor/bundle/ruby/1.9.1/gems/tilt-1.3.3/lib/tilt/template.rb:209:in `instance_eval'
/app/vendor/bundle/ruby/1.9.1/gems/tilt-1.3.3/lib/tilt/template.rb:209:in `evaluate_source'
/app/vendor/bundle/ruby/1.9.1/gems/tilt-1.3.3/lib/tilt/template.rb:144:in `cached_evaluate'
/app/vendor/bundle/ruby/1.9.1/gems/tilt-1.3.3/lib/tilt/template.rb:127:in `evaluate'
/app/vendor/bundle/ruby/1.9.1/gems/tilt-1.3.3/lib/tilt/template.rb:76:in `render'
/app/lib/asciidoc.rb:95:in `render'
/app/lib/asciidoc.rb:649:in `render'
/app/lib/tasks/index.rake:107:in `block (3 levels) in <top (required)>'
/app/lib/tasks/index.rake:80:in `each'
/app/lib/tasks/index.rake:80:in `block (2 levels) in <top (required)>'
/app/lib/tasks/index.rake:23:in `each'
/app/lib/tasks/index.rake:23:in `block in <top (required)>'
/app/vendor/bundle/ruby/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:205:in `call'
/app/vendor/bundle/ruby/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:205:in `block in execute'
/app/vendor/bundle/ruby/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:200:in `each'
/app/vendor/bundle/ruby/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:200:in `execute'
/app/vendor/bundle/ruby/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:158:in `block in invoke_with_call_chain'
/usr/local/lib/ruby/1.9.1/monitor.rb:201:in `mon_synchronize'
/app/vendor/bundle/ruby/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:151:in `invoke_with_call_chain'
/app/vendor/bundle/ruby/1.9.1/gems/rake-0.9.2.2/lib/rake/task.rb:144:in `invoke'
/app/vendor/bundle/ruby/1.9.1/gems/rake-0.9.2.2/lib/rake/application.rb:116:in `invoke_task'
/app/vendor/bundle/ruby/1.9.1/gems/rake-0.9.2.2/lib/rake/application.rb:94:in `block (2 levels) in top_level'
/app/vendor/bundle/ruby/1.9.1/gems/rake-0.9.2.2/lib/rake/application.rb:94:in `each'
/app/vendor/bundle/ruby/1.9.1/gems/rake-0.9.2.2/lib/rake/application.rb:94:in `block in top_level'
/app/vendor/bundle/ruby/1.9.1/gems/rake-0.9.2.2/lib/rake/application.rb:133:in `standard_exception_handling'
/app/vendor/bundle/ruby/1.9.1/gems/rake-0.9.2.2/lib/rake/application.rb:88:in `top_level'
/app/vendor/bundle/ruby/1.9.1/gems/rake-0.9.2.2/lib/rake/application.rb:66:in `block in run'
/app/vendor/bundle/ruby/1.9.1/gems/rake-0.9.2.2/lib/rake/application.rb:133:in `standard_exception_handling'
/app/vendor/bundle/ruby/1.9.1/gems/rake-0.9.2.2/lib/rake/application.rb:63:in `run'
/app/vendor/bundle/ruby/1.9.1/gems/rake-0.9.2.2/bin/rake:33:in `<top (required)>'
/app/vendor/bundle/ruby/1.9.1/bin/rake:19:in `load'
/app/vendor/bundle/ruby/1.9.1/bin/rake:19:in `<main>'
Tasks: TOP => preindex

Incorporate new homepage design

Incorporate Jason's new homepage design.

Man pages are slow

Not sure what's going on with the manual pages but they've been ridiculous slow to load so far using them as my primary help with e.g., git help log -w. I'm waiting around 2 - 3 seconds in most cases. These should never be > 50ms on the server.

I'd be happy to look into perf here, just want to make sure its not a known thing someone's working on.

Missing Domo-Kun

Love the new clean design but I very much miss Domo-Kun eating the trees.

No license

Even if this site isn't really open sourced, it'd be nice to make the licensing explicit.

GUI Clients visibility on Windows

When visiting http://git-scm.com/downloads/guis and clicks Only show GUIs for my OS (Windows), all the visible boxes grey out. I can't see any non-grey boxes on my 1280x1024 screen unless I scroll or the browser is maximized.

Page titles are not updated

The page title needs to be updated. Now its just 'Git' everywhere.

search bar functionality

search bar should search through:

• command names
• man-pages (most recent first)
• pro-git book
• stack overflow questions (?)
• release notes (?)

it should look similar to this:

Download landing page url changed, does not redirect

The previous download url for git-scm.com was http://git-scm.com/download, this has now been changed to http://git-scm.com/downloads in most cases (not all, there's still subpages such as http://git-scm.com/download/gui/linux). Would a redirect from http://git-scm.com/download to http://git-scm.com/downloads be possible?

fix broken links to individual videos

On the Documentation page, there is a Videos section. There are two types of links to individual videos on that page, and both of them are broken. Clicking on any title card image goes to /video/what-is-git, no matter what video is clicked. And clicking on any video title below, e.g. "What is Version Control?", goes to /doc.

Here are the relevant places in the code:

• /app/views/doc/index.html.haml line 81 for the title card link in the view
• /app/views/doc/index.html.haml line 82 for the title heading link in the view
• /app/controllers/doc_controller.rb line 8 for the controller assignment of @videos
• /app/controllers/doc_controller.rb line 164 for the hard-coded two-dimensional array of video data

Windows download page recommends Mac GUI tools.

http://git-scm.com/download/win helpfully notes that Several free and commercial GUI tools are available for the Mac platform.

Trivial XSS

http://git-scm.com/search/results?search="><script>alert(0)</script>

Some in page man links are broken

For instance, visit the git-help(1) manpage and find the link for "git-webbrowse". It points to the following URL, which results in a redirect to /docs/:

http://git-scm.com/docs/git-webbrowse.html

git-merge asciidoc weirdness

git-merge issue:

Hard to find source tarball link

Actual: Go to the new homepage, see a big "download for Mac" button.
Expected: Also see a big "download a source tarball" button. The Source link I did find brought me to GitHub.

degrade gracefully when javascript is disabled

This site is going to get a much wider audience than github.com (or at least we want it to; it should be the official git site). We're going to get people viewing it with w3m, browsers with super locked-down javascript settings, etc. I noticed two issues with javascript turned off:

1. (very minor) The download button defaults to "Download for Mac" when javascript is off. If we can't do OS detection, it might make sense to point to something more agnostic.
2. On the "community" page, the mailto: link for the list does not appear at all if javascript is turned off. It just appears as "[...] using the email address .".

auto man-page generator

need some way to find, pull and build man-page docs from source.

i would prefer to just do it from source too, in case junio decides not to publish the html branch anymore. back fill it with all old releases too.

pre text formatting issue

At the bottom of the show-branch docs:

http://git-scm.herokuapp.com/ref/git-show-branch

There are a couple of weird formatting issues.

make favicon of new logo

use new logo in more places:

user-manual not indexing

this should display the user-manual:

http://git-scm.herokuapp.com/ref/user-manual

make it clearer that videos are videos on Documentation page

Page: http://git-scm.com/documentation

This person's description of their thought process when viewing the site included thinking that the videos were "brightly colored business cards". It took him a moment to realize that they were videos. That those rectangles were videos was not obvious to me, too, when I saw that part of the page.

I suggest overlaying a play icon ▶ over the video title card somewhere. This is reminiscent of the embedded video players for many video sites, and should remind the user of a video more clearly.

Things to consider about the play icon layout:

• put the ▶ in the center or the corner of the card?
• should the ▶ be plain, in a circle, or in a box?
• should the title card be dimmed or not?

man page / doc landing page

show all the man pages, grouped by function, linking to man page permalinks

Asciidoc doesn't support nested definition lists

Or other nested lists for that matter..

Eg. the recursive merge strategy options in git-rebase

build and maintain search database

scripts to fill and maintain elasticsearch db on heroku

asciidoc should handle inline literals

There's a pending change in upstream git to turn on asciidoc's "inline literal" feature. The source files are being tweaked accordingly; you can see the result at git/git@6cf378f. When this hits, we'll have to adjust our parser to handle the new syntax (but keep using the old syntax for older versions).

/cc @nickh

Add a license

No point having forks of software that can't be modified!

auto-download os specific version

we need to detect the user environment and offer in a single click the correct software to download, then possibly redirect to instructions on how to install it and get started. also possibly link to GUIs?

Link to GitTogether conference is broken

The link to the GitTogether conference on the Software Freedom Conservancy page is broken. Right now, it points to https://git.wiki.kernel.org/articles/g/i/t/GitTogether_3474.html

About page link issue

1. Navigate to http://git-scm.com/about
2. Clik on Small and Fast →
3. Next page is scrolled all the way to the bottom of the page! Very, very irritating.

Can this be fixed? Love the next site, btw.

new wiki

the previous wiki was OK and a lot of people used it, but it's now dead due to k.org biting the bullet.

implement a new wiki interface and way to contribute super easily.

import the old wiki, too.

asciidoc *note* tag not parsing correctly

On the rebase page, if you compare this:

http://git-scm.herokuapp.com/ref/git-rebase

to this:

http://git-scm.blackantmedia.com/documentation/reference/rebase.html

There is a NOTE section that is not being parsed correctly.

easy pro git content linking

easy to link to pro git content and permalinks

implement man-page browser design

use Jason's new man-page browser design

deprecate git community book

replace all urls with redirects to pro git or tutorial equivalents

Download version is different than what you get

The home page says:

Latest stable release
1.7.10.1
Release Notes (2012-05-02)
DOWNLOAD

Clicking DOWNLOAD will immediately start the download for 1.7.10.0 because .1 is not yet released for Windows. That's stupid.

Don't start download right away, either link to the mSys downloads page like before (best) or if you really want to show-off your downloads page, fine, but don't start the download when the version above the download button is different than the version you are giving the user.

Duplicate search results / one 500s

If I search for stashing I see two results:

Result URL differ in case; one throws a 500 error:

• https://git-scm.herokuapp.com/book/en/Git-Tools-Stashing 👍
• https://git-scm.herokuapp.com/book/en/git-tools-stashing 👎

PS: Awesome work - the new site looks amazing!

Potentially wrong installation instruction for Debian users?

I'm not very sure of this, so please cross check before any action.

On Debian Sid (Unstable), the package manager says,

This is a transitional dummy package. The 'git-core' package has been renamed to 'git', which has been installed automatically. This git-core package is now obsolete, and can safely be removed from the system if no other package depends on it

So Ideally the command should be # apt-get install git

Also the prompt should be # and not $, just to say that the user needs a root shell.

learning git screencasts

some high quality getting started screencasts for git

clean up favicon by removing semi-transparent pixels

The favicon (/public/favicon.ico, or see on live site) looked a bit messy when I first saw it. In the middle of the vertical branch are some semi-transparent orange pixels. I'm talking about the pixels at the X:

          ^
        /   \
      /\      \
    /    \      \
  /       \        \
<         | \       >
  \       X  o    /
    \     |     /
      \   o   /
        \   /
          V

Those pixels are meant to indicate that the line is narrower than the bubble at the end, as you can see by looking at a bigger version of Git's logo (logo in site header, larger plain logo). However, when I first went to the new Git website, I didn't look at the new logo for a while. Before I saw it, I saw the favicon, after switching tabs. I thought that the favicon looked a bit messy in the middle, at the X. It looks more like the image is blurry than that that section of the line is narrow.

Now that I have seen the bigger version of the icon, I find it harder to see those pixels as blur and see them mostly as a narrower line instead. But I think a significant number of other new visitors will interpret it as ugly blur, seeing the favicon before the header logo.

My suggested fix: make that part of the line just as wide as the other parts. The diagonal line is already at the same width in the line and at the end, and it looks fine. I think the concept of the branch will still be conveyed well enough even if the commit node at the end isn't wider than the line.

This change was first suggested by someone else, on Hacker News. They probably had the same problem that I did.

incorporate pro git content or cross link

the pro git book content should be first class content on the site. search should link to it and links should return

bisect asciidoc rendering issue

near "# tweak the working tree" a bunch of formatting is off.

also link:git-bisect-lk2009.html[Fighting regressions with git bisect] is not rendered.

incorporate gitref.org content

all the gitref.org content should be in git-scm

bullets issues in rev-parse

http://git-scm.herokuapp.com/docs/git-rev-parse#_specifying_revisions