From: Junio C Hamano <gitster@pobox.com>
To: "Julia Evans via GitGitGadget" <gitgitgadget@gmail.com>
Cc: git@vger.kernel.org, Tuomas Ahola <taahol@utu.fi>,
Kristoffer Haugsbakk <kristofferhaugsbakk@fastmail.com>,
Julia Evans <julia@jvns.ca>
Subject: Re: [PATCH v3 2/2] doc: remove references to gittutorial-2
Date: Mon, 26 Oct 2026 15:36:12 -0700 [thread overview]
Message-ID: <xmqqse1snl7n.fsf@gitster.g> (raw)
In-Reply-To: <0a42345cecec10bd32ae3db1a699452b164a2f25.1793022742.git.gitgitgadget@gmail.com> (Julia Evans via GitGitGadget's message of "Mon, 26 Oct 2026 13:52:22 +0000")
"Julia Evans via GitGitGadget" <gitgitgadget@gmail.com> writes:
Forgot to mention one more thing.
> 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.
next prev parent reply other threads:[~2026-10-26 22:36 UTC|newest]
Thread overview: 38+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-09-28 20:25 [PATCH 0/3] [doc] Remove gittutorial-2 Julia Evans via GitGitGadget
2026-09-28 20:25 ` [PATCH 1/3] " Julia Evans via GitGitGadget
2026-09-28 20:25 ` [PATCH 2/3] [doc] Remove references to gittutorial-2 Julia Evans via GitGitGadget
2026-09-28 20:25 ` [PATCH 3/3] [doc] Delete translations of gittutorial-2 description Julia Evans via GitGitGadget
2026-09-29 7:50 ` [PATCH 0/3] [doc] Remove gittutorial-2 Junio C Hamano
2026-09-29 10:42 ` Julia Evans
2026-09-29 11:09 ` Julia Evans
2026-09-30 7:50 ` Junio C Hamano
2026-10-01 22:21 ` Julia Evans
2026-10-02 7:38 ` Junio C Hamano
2026-09-29 21:58 ` Junio C Hamano
2026-09-29 22:24 ` Junio C Hamano
2026-09-30 6:15 ` Tuomas Ahola
2026-09-30 14:22 ` Junio C Hamano
2026-09-30 13:16 ` Julia Evans
2026-09-30 14:07 ` Kristoffer Haugsbakk
2026-09-30 6:00 ` Tuomas Ahola
2026-09-30 14:01 ` Julia Evans
2026-10-05 20:20 ` [PATCH v2 0/2] " Julia Evans via GitGitGadget
2026-10-05 20:20 ` [PATCH v2 1/2] doc: remove gittutorial-2 Julia Evans via GitGitGadget
2026-10-05 20:37 ` Kristoffer Haugsbakk
2026-10-05 20:20 ` [PATCH v2 2/2] doc: remove references to gittutorial-2 Julia Evans via GitGitGadget
2026-10-05 20:37 ` [PATCH v2 0/2] [doc] Remove gittutorial-2 Junio C Hamano
2026-10-06 5:50 ` Tuomas Ahola
2026-10-06 17:17 ` Junio C Hamano
2026-10-06 18:45 ` Tuomas Ahola
2026-10-06 20:48 ` Junio C Hamano
2026-10-06 17:34 ` Julia Evans
2026-10-26 11:00 ` Tuomas Ahola
2026-10-26 12:10 ` Julia Evans
2026-10-26 13:13 ` Tuomas Ahola
2026-10-26 13:57 ` Julia Evans
2026-10-26 17:05 ` Junio C Hamano
2026-10-26 13:52 ` [PATCH v3 " Julia Evans via GitGitGadget
2026-10-26 13:52 ` [PATCH v3 1/2] doc: remove gittutorial-2 Julia Evans via GitGitGadget
2026-10-26 13:52 ` [PATCH v3 2/2] doc: remove references to gittutorial-2 Julia Evans via GitGitGadget
2026-10-26 22:36 ` Junio C Hamano [this message]
2026-10-26 17:15 ` [PATCH v3 0/2] [doc] Remove gittutorial-2 Junio C Hamano
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=xmqqse1snl7n.fsf@gitster.g \
--to=gitster@pobox.com \
--cc=git@vger.kernel.org \
--cc=gitgitgadget@gmail.com \
--cc=julia@jvns.ca \
--cc=kristofferhaugsbakk@fastmail.com \
--cc=taahol@utu.fi \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.