Git development
 help / color / mirror / Atom feed
From: "Julia Evans via GitGitGadget" <gitgitgadget@gmail.com>
To: git@vger.kernel.org
Cc: Tuomas Ahola <taahol@utu.fi>,
	Kristoffer Haugsbakk <kristofferhaugsbakk@fastmail.com>,
	Julia Evans <julia@jvns.ca>
Subject: [PATCH v2 0/2] [doc] Remove gittutorial-2
Date: Mon, 05 Oct 2026 20:20:08 +0000	[thread overview]
Message-ID: <pull.2241.v2.git.1791231610.gitgitgadget@gmail.com> (raw)
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

  parent reply	other threads:[~2026-10-05 20:20 UTC|newest]

Thread overview: 28+ 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 ` Julia Evans via GitGitGadget [this message]
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

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=pull.2241.v2.git.1791231610.gitgitgadget@gmail.com \
    --to=gitgitgadget@gmail.com \
    --cc=git@vger.kernel.org \
    --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 a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox