From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from linux.microsoft.com (linux.microsoft.com [13.77.154.182]) by mx.groups.io with SMTP id smtpd.web11.138968.1671122318607004828 for ; Thu, 15 Dec 2022 08:38:38 -0800 Authentication-Results: mx.groups.io; dkim=pass header.i=@linux.microsoft.com header.s=default header.b=F8a1BDx5; spf=pass (domain: linux.microsoft.com, ip: 13.77.154.182, mailfrom: mikuback@linux.microsoft.com) Received: from [192.168.4.22] (unknown [47.201.8.94]) by linux.microsoft.com (Postfix) with ESMTPSA id 589B620B87C3; Thu, 15 Dec 2022 08:38:37 -0800 (PST) DKIM-Filter: OpenDKIM Filter v2.11.0 linux.microsoft.com 589B620B87C3 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linux.microsoft.com; s=default; t=1671122318; bh=ngcy2ro1t1z5wfxmAFaoWNhp6ct/e8eqKIminpKPIjg=; h=Date:Subject:To:Cc:References:From:In-Reply-To:From; b=F8a1BDx5obCNtTyg/uv12apBUBvcLyWV4YRcYuLZFr1VIYBrLzwE5oo2NiZW5PGTd bzQSjRQ5SVH1hYqDpQ1D/N+qygIaNVqDBIUrCOZmJ3v3LB306HHXmS//CQhzX4guA/ VU2V7FOp9JUsSoFuiKdrlFyLmkY0nstvvujRIRGQ= Message-ID: <843b47a9-d6ee-31dd-fd21-363f3ce8ddc9@linux.microsoft.com> Date: Thu, 15 Dec 2022 11:38:36 -0500 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (Windows NT 6.2; Win64; x64; rv:91.0) Gecko/20100101 Thunderbird/91.13.1 Subject: Re: [edk2-devel] [PATCH v3 13/14] ArmPkg: Turn off spellcheck audit mode To: devel@edk2.groups.io, quic_llindhol@quicinc.com Cc: ardb@kernel.org, Ard Biesheuvel , Sami Mujawar , "Kinney, Michael D" References: <20221214225252.1660-1-mikuback@linux.microsoft.com> <20221214225252.1660-14-mikuback@linux.microsoft.com> <9c88fe54-5e83-fb43-b845-af4a79eaef79@linux.microsoft.com> <910eccca-b219-86ae-5550-339650b69461@linux.microsoft.com> From: "Michael Kubacki" In-Reply-To: Content-Language: en-US Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit On 12/15/2022 5:42 AM, Leif Lindholm wrote: > On Wed, Dec 14, 2022 at 19:04:06 -0500, Michael Kubacki wrote: >> I'm just trying to understand your position. >> >> Are you saying you would rather people check in typos and then later have >> patches come into the package to fix them? >> >> For example, like these: >> >> - ArmVirtPkg: https://edk2.groups.io/g/devel/message/97021 >> - ArmPkg: https://edk2.groups.io/g/devel/message/97022 >> >> Why not just have the code checked in without typos in the first place? > > A little fairy once whispered in my ear that if I stopped myself and > tried to rephrase whenever I found myself using the work "just", I > would meet less friction in context-stripping communication mediums > such as email. They weren't wrong. > This topic is met with friction regardless of how it is phrased. The friction exists because the community chose to enable spell checking in CI and it is not wanted here. The mechanism chosen to ignore words was through YAML files rather than a button. A common YAML file can store words for the whole project and packages can add package-specific words. The community was expected to make the contributions necessary in the common file to minimize impact on package maintainers. The spellcheck log outputs the exact code that needs to be copied/pasted to the exception list - whether the global list or package list. If you run CI locally, you can copy/paste the exact lines needed. This is a patch series I work on in my spare time to try to improve the project. I am tired of Ard's dismissive and passive aggressive responses such as those in https://edk2.groups.io/g/devel/message/97433 so I revoke the series and will let others decide what they want to do. >> Checking in typos creates more review work, makes the code history have typo >> fix patches that could be avoided, and impacts accessibility. >> >> I spend far more time with edk2 overhead such as email formatting problems, >> keeping track of maintainer email address changes when updating patches, >> mapping email replies back to code, and so on that does not improve the >> code. A spell checker only takes seconds and is built into edk2 CI. > > We didn't disable the spellchecker for the ARM* packages (only) > because we hate correct spelling. We disabled it because it throws > false positives left right and centre. So we end up needing to update > the .ci.yaml every time we mention an architectural concept we haven't > mentioned before. Or add a copyright line mentioning a new > organisation. Or correctly use apostrophes in ways the spellchecker > doesn't expect. > > Here is the current (and very incomplete, oh - and package specific) > exception list for ArmPkg: > > https://github.com/tianocore/edk2/blob/master/ArmPkg/ArmPkg.ci.yaml#L95 > > If it had a aggressiveness knob and we could turn it down from 11 to > 3 and work our way up from there, that would be another story. > > Failing that, a push-through-anyway-this-isn't-a-typo label would be a > reasonable compromise. > > But for now, I agree with Ard. > > / > Leif > >> On 12/14/2022 6:24 PM, Ard Biesheuvel wrote: >>> On Thu, 15 Dec 2022 at 00:21, Michael Kubacki >>> wrote: >>>> >>>> Yes. It will also reduce frequency of incoming patches that must be >>>> reviewed and merged due to people continuously fixing trivial spelling >>>> errors. >>>> >>> >>> In that case, NAK to this patch (and the ArmVirtPkg one). Unless we >>> add a button to the GitHub UI that permits me to override a negative >>> CI result on a PR. >>> >>>> On 12/14/2022 6:07 PM, Ard Biesheuvel wrote: >>>>> On Wed, 14 Dec 2022 at 23:53, wrote: >>>>>> >>>>>> From: Michael Kubacki >>>>>> >>>>>> Audit mode was enabled for the spellcheck CI plugin. It is no longer >>>>>> needed with recent changes. Spelling errors can be checked in the >>>>>> package moving forward. >>>>>> >>>>>> Cc: Leif Lindholm >>>>>> Cc: Ard Biesheuvel >>>>>> Cc: Sami Mujawar >>>>>> Signed-off-by: Michael Kubacki >>>>> >>>>> Will this patch result in PRs potentially being rejected by pre-merge >>>>> CI due to trivial spelling errors? >>>>> >>>>> >>>>>> --- >>>>>> ArmPkg/ArmPkg.ci.yaml | 3 ++- >>>>>> 1 file changed, 2 insertions(+), 1 deletion(-) >>>>>> >>>>>> diff --git a/ArmPkg/ArmPkg.ci.yaml b/ArmPkg/ArmPkg.ci.yaml >>>>>> index c8dface6821a..a304c7966cf7 100644 >>>>>> --- a/ArmPkg/ArmPkg.ci.yaml >>>>>> +++ b/ArmPkg/ArmPkg.ci.yaml >>>>>> @@ -87,7 +87,7 @@ >>>>>> >>>>>> ## options defined .pytool/Plugin/SpellCheck >>>>>> "SpellCheck": { >>>>>> - "AuditOnly": True, >>>>>> + "AuditOnly": False, >>>>>> "IgnoreFiles": [ >>>>>> "Library/ArmSoftFloatLib/berkeley-softfloat-3/**" >>>>>> ], # use gitignore syntax to ignore errors >>>>>> @@ -148,6 +148,7 @@ >>>>>> "fcmplt", >>>>>> "ffreestanding", >>>>>> "frsub", >>>>>> + "hauser", >>>>>> "hisilicon", >>>>>> "iccabpr", >>>>>> "iccbpr", >>>>>> -- >>>>>> 2.28.0.windows.1 >>>>>> >>> >>> >>> >>> > > > >