From: Ben Knoble Date: Tue, 31 Mar 2026 12:35:49 GMT Subject: Re: [PATCH 2/2] doc: interpret-trailers: explain key format Message-ID: <8E736B70-424E-48AC-A6D0-9A8B091D21F6@gmail.com> In-Reply-To: <5ba0bbcb-25a7-4ad0-ac1d-c86508eaffdd@app.fastmail.com> > Le 30 mars 2026 à 18:26, Kristoffer Haugsbakk 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.