Code

Documentation: add git user's manual
authorJ. Bruce Fields <bfields@citi.umich.edu>
Mon, 8 Jan 2007 00:23:49 +0000 (19:23 -0500)
committerJ. Bruce Fields <bfields@citi.umich.edu>
Mon, 8 Jan 2007 01:33:06 +0000 (20:33 -0500)
commitd19fbc3c171aa71a79b2ff0b654e3064c91628b8
tree8226b4f70f272eaed7538e33d626e6aa2252bae1
parent13e86efbeae5994a85cc482b3964db7298c5c6ea
Documentation: add git user's manual

The goals are:

- Readable from beginning to end in order without having read
  any other git documentation beforehand.
- Helpful section names and cross-references, so it's not too
  hard to skip around some if you need to.
- Organized to allow it to grow much larger (unlike the
  tutorials)

It's more liesurely than tutorial.txt, but tries to stay focused on
practical how-to stuff.  It adds a discussion of how to resolve merge
conflicts, and partial instructions on setting up and dealing with a
public repository.

I've lifted a little bit from "branching and merging" (e.g., some of the
discussion of history diagrams), and could probably steal more if that's
OK.  (Similarly anyone should of course feel free to reuse bits of this
if any parts seem more useful than the whole.)

There's a lot of detail on managing branches and using git-fetch, just
because those are essential even to people needing read-only access
(e.g., kernel testers).  I think those sections will be much shorter
once the new "git remote" command and the disconnected checkouts are
taken into account.

I do feel bad about adding yet another piece of documentation, but I we
need something that goes through all the basics in a logical order, and
I wasn't seeing how to grow the tutorials into that.

Signed-off-by: "J. Bruce Fields" <bfields@citi.umich.edu>
Documentation/Makefile
Documentation/docbook-xsl.css [new file with mode: 0644]
Documentation/user-manual.conf [new file with mode: 0644]
Documentation/user-manual.txt [new file with mode: 0644]