Skip to content

Add lychee GitHub action to automatically check for broken links #134

Open
4 of 4 issues completed

Description

@dlebauer

Add Github Action workflow that checks for broken links.

This should check both external links and internal references.

Follow the approach we used in the SIPNET repository (.github/workflows/link-check.yml, implement a Lychee GHA

Confirm that broken links in sub-issues are caught by checker. Make sure those are fixed alongside this implementation.

Activity

  1. Avneetsingh18-doit commented on Jan 31, 2026

    @Avneetsingh18-doit

    Hi, please assign this issue to me. my approach: I will check all the links in the repository, find any broken ones, fix them, and push the changes.

  2. dlebauer commented on Feb 1, 2026

    @dlebauer
    MemberAuthor

    @Avneetsingh18-doit thanks for your interest! Could you please review #135 and see if that is a fix, and if any changes are needed?

  3. Avneetsingh18-doit commented on Feb 1, 2026

    @Avneetsingh18-doit

    Hi @dlebauer, sure I’ll review PR #135 and get back with feedback shortly.

  4. Avneetsingh18-doit commented on Feb 7, 2026

    @Avneetsingh18-doit

    I reviewed the workflow and tested the link checker with a few configuration tweaks . With some adjustments, we should be able to surface the broken links that were previously reported. If this sounds good, please feel free to assign this to me and I can raise a follow-up PR to address it.

  5. dlebauer commented on Mar 17, 2026

    @dlebauer
    MemberAuthor

    Thanks, @Avneetsingh18-doit - I've assigned it to you.

  6. Avneetsingh18-doit commented on Mar 21, 2026

    @Avneetsingh18-doit
  7. ANAMASGARD commented on May 5, 2026

    @ANAMASGARD

    Sir @dlebauer just a follow up is this issue still open is anyone working on it , if not I would like to work on it , Thank You .

  8. ANAMASGARD commented on Jul 20, 2026

    @ANAMASGARD

    Hi @dlebauer, I tested a localhost-based Lychee setup against the rendered Docusaurus site.

    It correctly detects internal route failures, including these four currently broken links from the Package Documentation
    page:

    • /package-documentation/develop/
    • /package-documentation/latest/
    • /package-documentation/v1.10.0/
    • /package-documentation/v1.9.0/

    Could you please confirm the intended destination URL for each of these package-documentation versions? I do not want to
    guess and point users to the wrong documentation.

    I also found a larger backlog of historical external links that return 404, 410, authentication, or bot-blocking
    responses. Would you be comfortable with splitting the eventual workflow into:

    • a strict required check for internal site routes; and
    • a separate external-link audit while the historical external links are reviewed?

    I have not opened a PR yet, since the workflow would otherwise remain permanently failing.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions