Skip to content

Add scheduled link checker workflow #23

Description

@ashleymcnamara

What

Add a GitHub Actions workflow that automatically checks all links in this repo's markdown files for broken URLs.

This is a curated resource list with 450+ stars. Broken links = broken trust for people relying on these resources.

Workflow details:

Scheduled Link Checker

  • Run weekly (Sunday night) and on PRs that touch markdown files
  • Check all URLs in all .md files for:
    • 404 Not Found
    • Timeouts (10s threshold)
    • SSL certificate errors
    • Permanent redirects (flag but don't fail — the link still works)
  • On scheduled runs: open a GitHub issue listing all broken links found, grouped by file
  • On PR runs: fail the check if new broken links are introduced
  • Use lycheeverse/lychee-action or similar
  • Exclude known flaky URLs (add a .lycheeignore or equivalent config file)
  • Cache results to avoid hammering the same URLs every run
  • Add a link checker status badge to the README

Why

People use this list to learn to code. Every dead link is someone hitting a wall when they're trying to learn. Keeping links fresh is the single highest-impact maintenance task for this repo.

Metadata

Metadata

Labels

No labels
No labels

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions