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>
22 lines
427 B
Plaintext
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
|