Re: [PATCH v4 11/11] doc: interpret-trailers: document comment line treatment
"Kristoffer Haugsbakk" <[email protected]>
| Newsgroups | org.kernel.vger.git |
|---|---|
| Message-ID | <[email protected]> |
On Thu, Aug 6, 2026, at 13:52, D. Ben Knoble wrote: > Hi Kristoffer, > > On Thu, Jul 30, 2026 at 5:22 AM <[email protected]> wrote: >> >> From: Kristoffer Haugsbakk <[email protected]> >> >> Comment lines have always been ignored but this is not documented. >> >> The primary motivation here is to reasonably complete in the > > "to be"? Thanks. I keep staring at the text but in the end you need someone else to read it as well. >>[snip] >> Notes (series): >> v4: >> • Msg: rewrite motivation for documenting this. The motivation is >> not super solid, but it reflects my own ambiguity on the matter, >> so to speak; I think we ought to be very thorough about >> documenting the format, while making sure to not use the main text >> to exhaustively lay it all out. The information should be >> somewhere in this doc. But not in your face. > > I agree we should be thorough but not in your face, esp. based on the > work Julia Evans has done in the past around Git documentation. > Thanks! Thanks. I’m glad that I was able to communicate that. ;) > >>[snip]