Re: [PATCH v2] doc: use `man git` to teach users how to navigate the docs

From: Junio C Hamano <gitster@pobox.com>
Date: Oct 7, 2026, 17:35 UTC
Message-ID: <xmqqv77d8ld9.fsf@gitster.g>
In-Reply-To: <2ef42736-8879-4399-bbe9-3ba09522373d@app.fastmail.com>

"Julia Evans" <julia@jvns.ca> writes:

Show 18 quoted lines

> On Wed, Oct 7, 2026, at 9:47 AM, Junio C Hamano wrote:
>> "Julia Evans" <julia@jvns.ca> writes:
>>
>>>> Nitpick: Okay, but with the current commit message I don’t really
>>>> understand why the git.github.io link is gone. I have to guess that it
>>>> is an effective duplicate of git-scm or something since git-scm does
>>>> remain after this change.
>>>
>>> Yep! It has the same content as https://git-scm.com as far as I know,
>>
>> Correct.  That is direct rendition of what we ship.  git-scm.com has
>> some fruff around it (grouping and other meaningful usability
>> improvements besides coloring and fonts), but I do not know how
>> up-to-date the contents or the grouping is and how they are kept
>> synchronized to the originals at git.github.io/htmldocs/git.html.
>
> Yeah, the grouping at https://git-scm.com/docs is a bit out of date.
> I'm not sure how to fix it in a satisfactory way.

Another thing is I do not know how fresh the contents are. I know the one you are removing the reference to keeps up with the tip of 'main/master' so it may describe yet-to-be-released new features and behaviours. I am assuming that the one at git-scm.com is updated to the latest released version, which may be more useful for general audience.