This wiki is hosted on but not endorsed by or otherwise related to github.

Git Usability Sucks

This wiki documents the reasons that people find git confusing or difficult to use. Although the title is link-bait, the wiki is intended to be a valuable resource to git users, evaluators, implementors and successors.

Goals

  1. to serve as a map highlighting potential minefields that users may run into,
  2. to help people to evaluate git versus its competitors,
  3. to serve as a resource for people improving or wrapping git and
  4. to inform future SCM creators of areas where git is confusing to some users.

Contribute!

You can either contribute to the main wiki if you have a github account or you can email a gist to the maintainer.

Sections

Confusing commands
  • ...
  • ...
  • ...
Terminological quirks
  • Git calls the "staging area" the index
  • Git documentation uses three different terms for HEAD
  • ...
Divergences from RCS/CVS/SVN     
  • ...
  • ...
Documentation issues
  • ...
  • ...