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

[Tuomas Ahola <taahol@utu.fi>]

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

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

Thanks, that sounds great.

> 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.
> 
> Here's a pointer to a past discussion:
> 
> https://lore.kernel.org/git/7004c3b1-2100-4a90-9815-2a679ceb25b2@app.fastmail.com/T/#mf600063180d6239916e3fa6e9d33da86969547ec
> 
> Julia Evans (3):
>   [doc] Remove gittutorial-2
>   [doc] Remove references to gittutorial-2
>   [doc] Delete translations of gittutorial-2 description

Hmm, the normal format would be more like this:

	doc: remove gittutorial-2

Please note that the words in square brackets are dropped by git-am(1).  For
example, another patch series of yours is currently represented like this:

	$ git fetch https://github.com/gitster/git je/doc-merge-conflicts:je/doc-merge-conflicts 
	$ git shortlog origin/seen..je/doc-merge-conflicts 
	Julia Evans (7):
	      Add new gitmergeconflicts man page
	      git-merge: link to new merge conflicts guide
	      git-rebase: link to new merge conflicts guide
	      git-revert: link to new merge conflicts guide
	      git-cherry-pick: link to new merge conflicts guide
	      git-pull: link to new merge conflicts guide
	      ignore conflict markers in gitmergeconflicts.adoc

(And the fact that these are documentation patches is indeed something we would
like to preserve in the shortlog.)

--Tuomas