Re: [PATCH 0/3] [doc] Remove gittutorial-2

From: Junio C Hamano <gitster@pobox.com>
Date: Sep 29, 2026, 07:50 UTC
Message-ID: <xmqq5wzojy31.fsf@gitster.g>
In-Reply-To: <pull.2241.git.1790627122.gitgitgadget@gmail.com>

"Julia Evans via GitGitGadget" <gitgitgadget@gmail.com> writes:

> 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.

Is this the "two series" approach you mentioned earlier?

There is no need to ensure that the new document that replaces the old one covers everything the old one did. After all, giving us a clean slate and letting us choose what to cover (and, more importantly, what not to cover) with fresh eyes to match the needs of today's world is the whole point of redoing the tutorial document.

So I personally feel it is OK to remove the old one, without promising or even hinting at what in the new one that replaces it. But we would want to see its replacement in the not-so-distant future.

Also, we may want to decide what to do with gittutorial. It is short and reasonably sweet. One old-fashioned thing that does not exactly match today's prevalent usage patterns may be that it starts tracking a new project from a tarball, but other than that, it may not hurt to keep it around. I do not know.