Re: [PATCH 0/3] doc lint fixes for pack-refs and refs
From: Todd Zullinger <hidden>
Date: 2026-09-13 14:14:08
Hi, Jean-Noël AVILA wrote:
When I put this linting in place, I was specifically targeting the options. The other cases of use of definition list could range from commands to real definitions of words (see gitglossary.adoc and git-add.adoc), and extending the match can trigger false positives. Backticked terms are supposed to be immutable for translators, so this formatting should not be used for real definitions. For this reason, the regex is restricted on purpose, but selecting the files to check to allow to extend the range of checks. , FWIW, the proposed change triggers false positives for git-add.adoc, git- push.adoc, git-difftool.adoc, git-daemon.adoc and git-fetch.adoc.
That's fine, I don't mind dropping that patch if the false positives will be more annoying than skipping the checks for commands and missing some of them. I'll wait a little before sending a re-roll with that dropped, in case anyone spots issues in the main patches to the pack-refs and refs docs. Thanks, -- Todd