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

docs: Add missing spelling exception #26780

Merged
merged 1 commit into from Jul 12, 2023
Merged

docs: Add missing spelling exception #26780

merged 1 commit into from Jul 12, 2023

Conversation

qmonnet
Copy link
Member

@qmonnet qmonnet commented Jul 12, 2023

In commit e846b71, we removed many entries from the list of exceptions for the spell checker... In fact, I removed one too many. Here's what happened, as far as I
understand:

  • I removed all entries from spelling exceptions, then re-added just the necessary ones, locally.
  • When creating the PR, CI complained about people names.
    • The difference between local/CI is because (I think) Sphinx checks for contributors' names from the Git history.
    • In CI, we git clone --depth 1 so we don't have names of contributors for Sphinx.
  • So I re-added all names CI workflow was complaining about.
  • But... git clone --depth 1 still contains one commit, which was enough for Sphinx to find my name, so it didn't complain about it, and I didn't re-add it.
  • On PRs from different contributors though, it can't find my name and breaks.

Fixes: #26759

Really, I don't understand why “Monnet” is not universally known in every dictionary in the world 🙂

In commit e846b71 ("docs: Trim down spelling list"), we removed
many entries from the list of exceptions for the spell checker... In
fact, I removed one too many. Here's what happened, as far as I
understand:

  - I removed all entries from spelling exceptions, then re-added just
    the necessary ones, locally.
  - When creating the PR, CI complained about people names.
    - The difference between local/CI is because (I think) Sphinx checks
      for contributors' names from the Git history.
    - In CI, we git clone --depth 1 so we don't have names of
      contributors for Sphinx.
  - So I re-added all names CI workflow was complaining about.
  - But... "git clone --depth 1" still contains one commit, which was
    enough for Sphinx to find _my_ name, so it didn't complain about it,
    and I didn't re-add it.
  - On PRs from different contributors though, it can't find my name and
    breaks.

Fixes: e846b71 ("docs: Trim down spelling list")
Reported-by: André Martins <andre@cilium.io>
Reported-by: Timo Beckers <timo@isovalent.com>
Signed-off-by: Quentin Monnet <quentin@isovalent.com>
@qmonnet qmonnet added area/documentation Impacts the documentation, including textual changes, sphinx, or other doc generation code. kind/bug/CI This is a bug in the testing code. release-note/misc This PR makes changes that have no direct user impact. labels Jul 12, 2023
@qmonnet qmonnet requested a review from a team as a code owner July 12, 2023 09:45
@qmonnet qmonnet requested a review from lambdanis July 12, 2023 09:45
@ti-mo ti-mo added the ready-to-merge This PR has passed all tests and received consensus from code owners to merge. label Jul 12, 2023
@ti-mo
Copy link
Contributor

ti-mo commented Jul 12, 2023

Docs jobs looking green, let's get this merged to unblock other PRs.

@aanm aanm merged commit 40a0fc3 into cilium:main Jul 12, 2023
41 checks passed
@qmonnet qmonnet deleted the pr/monnet branch July 12, 2023 10:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/documentation Impacts the documentation, including textual changes, sphinx, or other doc generation code. kind/bug/CI This is a bug in the testing code. ready-to-merge This PR has passed all tests and received consensus from code owners to merge. release-note/misc This PR makes changes that have no direct user impact.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

4 participants