Skip to content

ci: add linkcheck_ignore for CI-blocked external links (#6 Category 4)#9

Merged
sanchuanhehe merged 1 commit into
mainfrom
fix/linkcheck-ignore-cat4
Jun 11, 2026
Merged

ci: add linkcheck_ignore for CI-blocked external links (#6 Category 4)#9
sanchuanhehe merged 1 commit into
mainfrom
fix/linkcheck-ignore-cat4

Conversation

@sanchuanhehe

Copy link
Copy Markdown
Member

Part of #6 (Category 4 — external link failures), production-repo side.

What

Adds linkcheck_ignore patterns to conf.py for external links that return HTTP 403 (or similar) to the linkcheck bot on CI runners, even though they resolve fine in a browser. This is a CI-runner blocking issue, not actual link breakage.

Ignored domains:
bls.gov, nytimes.com, unwomen.org, weforum.org, academic.oup.com, *.wiley.com (incl. onlinelibrary / spssi.onlinelibrary), huffpost.com, managers.org.uk, mayoclinic.org, teamblind.com, theburnoutproject.com.au, opavote.com.

Deliberately NOT ignored (genuine issues, kept visible)

  • The missing worksheet_for_community_audits.ods 404 → tracked in guidebook#263
  • The Deloitte blog 404 → real dead link, to be fixed/replaced in the guidebook source
  • The Stack Overflow text-fragment anchor → real anchor issue

Notes

Several external links return HTTP 403 (or similar) to the linkcheck bot on
CI runners even though they resolve fine in a browser. linkcheck is advisory,
but ignoring these known bot-blockers keeps the report focused on genuinely
broken links.

Only the consistently-blocking domains are ignored. Genuine breakage is left
visible on purpose:
- the missing worksheet .ods (tracked in guidebook#263)
- the Deloitte 404
- the Stack Overflow text-fragment anchor

Refs #6.
@sanchuanhehe sanchuanhehe merged commit 6291ec1 into main Jun 11, 2026
4 checks passed
@sanchuanhehe sanchuanhehe deleted the fix/linkcheck-ignore-cat4 branch June 11, 2026 06:47
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.

1 participant