git/list[1] front-page[2] threads[3] people[4] search[5] about
 

[PATCH v2 0/2] [doc] Remove gittutorial-2

From
Julia Evans via GitGitGadget <gitgitgadget@gmail.com>
Date
Oct 5, 2026, 20:20 UTC
Message-ID
<pull.2241.v2.git.1791231610.gitgitgadget@gmail.com>
In-Reply-To
<pull.2241.git.1790627122.gitgitgadget@gmail.com>

This patch series removes gittutorial-2 and all references to it, leaving a stub behind to help out any users who might be looking for this documentation.

The goal is to remove obsolete documentation and make it easier to improve our tutorial material in the future.

I tested that the docs are staying internally consistent by running git grep tutorial-2 and making sure that the only remaining references are in the Makefiles, the document itself, and some example output in user-manual.adoc which isn't relevant to the actual manual.

Changes in v2:
 * Remove changes to .po files (thanks to Junio)
 * Reword commit messages to doc: ... (thanks to Tuomas)

To deal with the conflict with 4ce144a1 (which requires that all guides be listed in command-list.txt) I think we need to add another exception to lint-manpages.sh (like Tuomas said).

Julia Evans (2):
  doc: remove gittutorial-2
  doc: remove references to gittutorial-2
 Documentation/MyFirstObjectWalk.adoc |   2 +-
 Documentation/git.adoc               |   2 +-
 Documentation/gitcore-tutorial.adoc  |   1 -
 Documentation/gitcvs-migration.adoc  |   2 +-
 Documentation/gitglossary.adoc       |   1 -
 Documentation/gittutorial-2.adoc     | 422 +--------------------------
 Documentation/gittutorial.adoc       |  23 +-
 7 files changed, 14 insertions(+), 439 deletions(-)
base-commit: 0f8e75abebff0877cae681a3d5ff31ac47f54220
Published-As: https://github.com/gitgitgadget/git/releases/tag/pr-2241%2Fjvns%2Fdelete-tutorial2-v2
Fetch-It-Via: git fetch https://github.com/gitgitgadget/git pr-2241/jvns/delete-tutorial2-v2
Pull-Request: https://github.com/gitgitgadget/git/pull/2241
Range-diff vs v1:
 1:  54404cd8df ! 1:  5fd36f91f0 [doc] Remove gittutorial-2
     @@ Metadata
      Author: Julia Evans <julia@jvns.ca>
      
       ## Commit message ##
     -    [doc] Remove gittutorial-2
     +    doc: remove gittutorial-2
      
          It hasn't been substantially updated for 20 years
          (see `git diff e31952da5c52a4c1:Documentation/tutorial-2.txt
 2:  a76819e3af ! 2:  68867aa3fc [doc] Remove references to gittutorial-2
     @@ Metadata
      Author: Julia Evans <julia@jvns.ca>
      
       ## Commit message ##
     -    [doc] Remove references to gittutorial-2
     +    doc: remove references to gittutorial-2
      
          Redirect folks to `gitdatamodel` instead, since every time it's
          referenced the intent is to explain objects, references, blobs, etc.
 3:  017ca1346d < -:  ---------- [doc] Delete translations of gittutorial-2 description
-- 
gitgitgadget
Previous: Julia EvansNext: Julia Evans via GitGitGadget
Message 19 of 28 in “[doc] Remove gittutorial-2”
  1. 0/3 [doc] Remove gittutorial-2Julia Evans via GitGitGadget, Sep 28, 2026
  2. 1/3 [doc] Remove gittutorial-2Julia Evans via GitGitGadget, Sep 28, 2026
  3. 2/3 [doc] Remove references to gittutorial-2Julia Evans via GitGitGadget, Sep 28, 2026
  4. 3/3 [doc] Delete translations of gittutorial-2 descriptionJulia Evans via GitGitGadget, Sep 28, 2026
  5. Junio C HamanoSep 29, 2026
  6. Julia EvansSep 29, 2026
  7. Julia EvansSep 29, 2026
  8. Junio C HamanoSep 30, 2026
  9. Julia EvansOct 1, 2026
  10. Junio C HamanoOct 2, 2026
  11. Junio C HamanoSep 29, 2026
  12. Junio C HamanoSep 29, 2026
  13. Tuomas AholaSep 30, 2026
  14. Junio C HamanoSep 30, 2026
  15. Julia EvansSep 30, 2026
  16. Kristoffer HaugsbakkSep 30, 2026
  17. Tuomas AholaSep 30, 2026
  18. Julia EvansSep 30, 2026
  19. 0/2 [doc] Remove gittutorial-2Julia Evans via GitGitGadget, Oct 5, 2026
  20. 1/2 doc: remove gittutorial-2Julia Evans via GitGitGadget, Oct 5, 2026
  21. Kristoffer HaugsbakkOct 5, 2026
  22. 2/2 doc: remove references to gittutorial-2Julia Evans via GitGitGadget, Oct 5, 2026
  23. Junio C HamanoOct 5, 2026
  24. Tuomas AholaOct 6, 2026
  25. Junio C HamanoOct 6, 2026
  26. Tuomas AholaOct 6, 2026
  27. Junio C HamanoOct 6, 2026
  28. Julia EvansOct 6, 2026

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.