Re: [PATCH 2/2] doc: interpret-trailers: explain key format

[Ben Knoble <ben.knoble@gmail.com>]

> Le 30 mars 2026 à 18:26, Kristoffer Haugsbakk <kristofferhaugsbakk@fastmail.com> a écrit :
> 
> On Mon, Mar 30, 2026, at 23:55, Junio C Hamano wrote:
>> kristofferhaugsbakk@fastmail.com writes:
>> 
>>> Just like *trailer* we emphasize these two first standalone word
>>> mentions.
>> 
>> Again, I have no idea what "these two first standalone word" wants
>> to refer to.  It is not even clear to me if it refers to a single
>> thing, or two things---the verb "mentions" hints that the subject of
>> the sentence must be plural, but I cannot tell what two things you
>> are referring to.
> 
> Key & value.
> 
> Something like:
> 
>    Just like *trailer* we emphasize these two first standalone word
>    mentions (key and value).
> 
> They are the only emphasized words in the diff. Although I *have* relied
> too much on the diff context before.

Perhaps “we emphasize the introduction of the terms ‘key’ and ‘value’” (much like a technical manual or paper may emphasize the first use of a new word or abbreviation, making subsequent uses link to it so readers can find the definition)?

I do find it interesting that the introduction is with an example rather than a definition. This suits “learning order” (concrete->abstract), but not necessarily “reference order” (where I just want to get to the definition). Hm.

I’m not sure I have any concrete suggestions, though.