Files
git/Documentation/gittutorial-2.adoc
T
Julia Evans bfae357a46 doc: remove gittutorial-2
It hasn't been substantially updated for 20 years
(see `git diff e31952da5c52a4c1:Documentation/tutorial-2.txt
               0f8e75abebff0877:Documentation/gittutorial-2.adoc`)
and it's becoming out of date, for example:

- refs do not necessarily live in `.git/refs`
- we don't really call it "the index file" anymore, and we don't
  encourage users to think about the individual files in `.git` as much
  as we did 20 years ago

More importantly, this approach of introducing Git by learning about the
contents of `.git` does not work for most people learning Git for the
first time. It's interesting information for some people (maybe more
advanced users or folks with a strong computer science background, for
not appropriate for a general tutorial).

Right now `gittutorial-2` is meant to be a logical sequel to
`gittutorial` ("read gittutorial, then gittutorial-2").
Deleting `gittutorial-2` means that we can more easily rewrite the main
`gittutorial` (which is also not effective) in any way we want, without
having to make sure that `gittutorial-2` is the logical next step.

We have other documentation which can serve a similar purpose to
tutorial-2 and isn't framed as a general tutorial appropriate for
everyone.

Keep building the man page for now and leave behind a stub to
redirect folks to those other documents.

Signed-off-by: Julia Evans <julia@jvns.ca>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
2026-10-26 15:23:04 -07:00

22 lines
427 B
Plaintext

gittutorial-2(7)
================
NAME
----
gittutorial-2 - Obsolete tutorial
DESCRIPTION
-----------
This tutorial has been deleted since it had become very stale.
See linkgit:gitdatamodel[7] for an explanation of how Git's core data
structures work (objects, references and the index).
See linkgit:gitcore-tutorial[7] for a practical tutorial on how to
explore Git's internals.
GIT
---
Part of the linkgit:git[1] suite