Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Testing:Developer] Remove CodeSpell #493

Merged
merged 5 commits into from
Apr 27, 2023
Merged

[Testing:Developer] Remove CodeSpell #493

merged 5 commits into from
Apr 27, 2023

Conversation

skara9
Copy link
Contributor

@skara9 skara9 commented Apr 27, 2023

Remove the codespell workflow.

@skara9 skara9 changed the title [Bugfix:Developer] CodeSpell Ignore Words [Bugfix:Developer] Remove CodeSpell Apr 27, 2023
@skara9 skara9 changed the title [Bugfix:Developer] Remove CodeSpell [Testing:Developer] Remove CodeSpell Apr 27, 2023
@bmcutler
Copy link
Member

This particular codespell package because it is not a full dictionary comparison, but rather an incomplete list of possible misspellings. We had multiple false negatives (unreported misspellings) and at least one false positive (correctly spelled name flagged as misspelled). We were not able to force skip the false positive, so we therefore decided the best course of action at this time is to remove this package.

@bmcutler bmcutler merged commit f215dfe into main Apr 27, 2023
@bmcutler bmcutler deleted the codespellignore branch April 27, 2023 20:31
@prestoncarman
Copy link
Contributor

The ignore words list must be lower case. Otherwise it will not recognize the word.

@prestoncarman
Copy link
Contributor

I did some research into the codespell documentation. It seems others have also found the ignore list confusing. They just updated the documentation (codespell-project/codespell#2466) to attempt to clarify how the ignore list is used. The updated readme has a section explaining how "Ignoring Words" works.

Posting a note here for future reference.

@skara9
Copy link
Contributor Author

skara9 commented May 2, 2023

@prestoncarman Thanks for the information, it's very much appreciated.

However, I think it's still best to leave out codespell from our PR workflow since its potential costs seem to outweigh the benefits in our case.

For example, say we add the pair tung=>tongue to the ignore file. Now this correction wouldn't be made across the whole site, which sort of defeats its purpose. We could alternatively provide the full line of occurrence to be ignored in another file, but then this would have to be updated every time the line is modified. If it isn't updated to match, we'd be leaving garbage.

Rather than having to maintain an exhaustive list of ignored word corrections and lines every time we update the documentation and always keep track of them, it would be much easier to routinely use some sort of simple browser extension to highlight unrecognized words which we can then discover and correct as necessary. This has the added benefit of working for all misspelled words and not just those that are in the codespell corrections list, which would otherwise fly under the radar.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants