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

Re: [PATCH v3 2/2] doc: remove references to gittutorial-2

From
Junio C Hamano <gitster@pobox.com>
Date
Oct 26, 2026, 22:36 UTC
Message-ID
<xmqqse1snl7n.fsf@gitster.g>
In-Reply-To
<0a42345cecec10bd32ae3db1a699452b164a2f25.1793022742.git.gitgitgadget@gmail.com>
"Julia Evans via GitGitGadget" <gitgitgadget@gmail.com> writes:
Forgot to mention one more thing.
Show 36 quoted lines
>  Documentation/gittutorial.adoc       | 23 +++++------------------
> ...
> diff --git a/Documentation/gittutorial.adoc b/Documentation/gittutorial.adoc
> index 519b8d8be2..006e534778 100644
> --- a/Documentation/gittutorial.adoc
> +++ b/Documentation/gittutorial.adoc
> @@ -622,24 +622,12 @@ Next Steps
>  ----------
>  
>  This tutorial should be enough to perform basic distributed revision
> -control for your projects.  However, to fully understand the depth
> -and power of Git you need to understand two simple ideas on which it
> -is based:
> +control for your projects.  However, to fully understand the Git
> +documentation, it's useful to learn how Git stores the history of
> +your project in its database. See linkgit:gitdatamodel[7] for an
> +explanation.
> ...
> -Part two of this tutorial explains the object
> -database, the index file, and a few other odds and ends that you'll
> -need to make the most of Git. You can find it at linkgit:gittutorial-2[7].
> -
> -If you don't want to continue with that right away, a few other
> -digressions that may be interesting at this point are:
> +A few other commands that may be interesting:
>  
>    * linkgit:git-format-patch[1], linkgit:git-am[1]: These convert
>      series of git commits into emailed patches, and vice versa,
> @@ -662,7 +650,6 @@ digressions that may be interesting at this point are:
>  
>  SEE ALSO
>  --------
> -linkgit:gittutorial-2[7],
>  linkgit:gitcvs-migration[7],
>  linkgit:gitcore-tutorial[7],
>  linkgit:gitglossary[7],

As the main tutorial is being rewritten from scratch, and it seems to assume that nobody has ever heard of gittutorial-2 ;-), the above patch would not merge well when both topics meet in 'seen'.

I do not think this topic to remove tutorial-2 would need further rework, but just in case if it ever becomes necessary, could you leave the changes out of this series? I can remember to take the other side and ignore the changes to the file done on this branch, but not having to remember one such thing helps quite a lot when you have to deal with 100+ merges to rebuild 'seen' on top of 'master', with updated topics of the day.

Thanks.
Previous: Julia Evans via GitGitGadgetNext: Junio C Hamano
Message 41 of 42 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. Tuomas AholaNov 5, 2026
  29. Junio C HamanoNov 5, 2026
  30. Tuomas AholaNov 5, 2026
  31. Junio C HamanoNov 5, 2026
  32. Julia EvansOct 6, 2026
  33. Tuomas AholaOct 26, 2026
  34. Julia EvansOct 26, 2026
  35. Tuomas AholaOct 26, 2026
  36. Julia EvansOct 26, 2026
  37. Junio C HamanoOct 26, 2026
  38. 0/2 [doc] Remove gittutorial-2Julia Evans via GitGitGadget, Oct 26, 2026
  39. 1/2 doc: remove gittutorial-2Julia Evans via GitGitGadget, Oct 26, 2026
  40. 2/2 doc: remove references to gittutorial-2Julia Evans via GitGitGadget, Oct 26, 2026
  41. Junio C HamanoOct 26, 2026
  42. Junio C HamanoOct 26, 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.