Skip to content

ci: exclude Microsoft Store & VS Code links from lychee link check#1645

Merged
sbryngelson merged 2 commits into
masterfrom
fix-lychee-403-excludes
Jul 15, 2026
Merged

ci: exclude Microsoft Store & VS Code links from lychee link check#1645
sbryngelson merged 2 commits into
masterfrom
fix-lychee-403-excludes

Conversation

@sbryngelson

Copy link
Copy Markdown
Member

Problem

The Build & Verify job's Lychee link check (docs.yml.lychee.toml) fails on three external links in documentation/getting-started.html that return 403 Forbidden to automated requests:

  • https://apps.microsoft.com/store/detail/ubuntu/9PDXGNCFSCZV
  • https://apps.microsoft.com/store/detail/windows-terminal/9N0DX20HK701
  • https://code.visualstudio.com/

These are live, correct links — the Microsoft Store and VS Code sites simply bot-block the checker (a common link-checker false positive). The failure is unrelated to the doc content and recurs on every run.

Fix

Add the two hosts to the existing exclude list in .lychee.toml, following the file's established pattern of host-specific excludes with an explanatory comment (as already done for olcf.ornl.gov → 503, sc22.supercomputing.org → 415, etc.).

Targeted host excludes are preferred over globally accepting 403 (which would mask genuinely dead links elsewhere in the docs).

Copilot AI review requested due to automatic review settings July 14, 2026 23:21

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot couldn't run its full agentic review because no GitHub Actions runner was available. Make sure your repository has a runner available to run Copilot's review, or add a copilot-setup-steps.yml file specifying one with the runs-on attribute. See the docs for more details.

Updates Lychee configuration to avoid CI failures caused by bot-blocked (403) but valid external links (Microsoft Store and VS Code).

Changes:

  • Add apps.microsoft.com to the Lychee exclude list to bypass Microsoft Store 403 responses.
  • Add code.visualstudio.com to the Lychee exclude list to bypass VS Code site 403 responses.

Comment thread .lychee.toml Outdated
Comment on lines +32 to +33
"https://apps\\.microsoft\\.com", # Microsoft Store returns 403 to automated requests
"https://code\\.visualstudio\\.com", # Returns 403 to automated requests
@sbryngelson sbryngelson merged commit db240d6 into master Jul 15, 2026
32 checks passed
@sbryngelson sbryngelson deleted the fix-lychee-403-excludes branch July 15, 2026 00:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants