Re: [PATCH] doc: remove mentions of .gitmodules !command syntax

From: Junio C Hamano <gitster@pobox.com>
Date: Jul 12, 2023, 17:54 UTC
Message-ID: <xmqqfs5tt3qz.fsf@gitster.g>
In-Reply-To: <d775437e-7fa3-189b-a1c3-4fd358dd9768@imap.cc>

Petar Vutov <pvutov@imap.cc> writes:

Show 8 quoted lines

> Perhaps the term "configuration variable" in
>
> "The following update procedures are only available via the
> submodule.<name>.update configuration variable:"
>
> is more specific and technical than immediately obvious - I would have
> expected the contents of .gitmodules to be a form of (repository)
> configuration. But that is just bikeshedding.

Not necessarily. It is always good to learn how "normal people" (read: those other than who develop and write documentation for Git) would react to and understand what we write in the manual pages, as that is the only way we can find what is confusing, ambiguous and can be improved.

Perhaps

    "... available via the ... configuration variable, and cannot be
    used in the .gitmodules file"

would have helped you?

Thanks.