Skip to content

fix(links): repair the dead links the nightly lychee run reports - #114

Merged
meysam81 merged 1 commit into
mainfrom
fix/lychee-dead-links
Nov 3, 2026
Merged

meysam81 merged 1 commit into
mainfrom
fix/lychee-dead-links

Conversation

@meysam81

@meysam81 meysam81 commented Nov 3, 2026

Copy link
Copy Markdown
Contributor

Cause. The nightly lychee job on main fails with 20 errors (run 41429685757):

  • Dead links: github.com/ente-io/ente/pkgs/container/server (404) and Promtail's #journal docs under loki/latest (404).
  • Bot challenge: onelogin's OIDC-vs-SAML page answers 202. It's an AWS WAF challenge with an empty body (x-amzn-waf-action: challenge).
  • Root-relative links: /login, /register, /assets/styles.css and others in the sample HTML under docs/blog/codes/2024/0012/, plus /feed_rss_created.xml in the ente post. lychee can't resolve those in local files.

Fix.

  • ente: the org moved from ente-io to ente, so the footnote now points to github.com/ente/ente/pkgs/container/server (200; ghcr.io/ente/server has 39 tags).
  • Promtail: the sentence cites Promtail's journal support, so the footnote points to the versioned docs loki/v3.5.x/send-data/promtail/configuration/#journal, which still have the #journal section, rather than Alloy's docs.
  • ente post RSS link: the absolute URL https://developer-friendly.blog/feed_rss_created.xml (200).
  • onelogin: excluded in lychee.toml, with a comment; a headless browser renders it ("SAML vs OIDC: All You Need to Know").
  • Sample pages: docs/blog/codes/2024/0012/ added to exclude_path; those links only resolve when the app is served.

Proof. lychee 0.24.2 with this config over ./**/*.md ./**/*.html ./**/*.rst, as the action runs it, reports 0 errors (580 OK, 541 excluded). Three timeouts remain locally (casbin.org and the two pre-commit.ci badge URLs); they are slow from my network, and the CI run had none.

- ente moved its GitHub org from ente-io to ente; the server package
  page lives at github.com/ente/ente/pkgs/container/server.
- Grafana removed the Promtail docs from "latest"; the sentence cites
  Promtail's journal support, so point at the v3.5.x docs, which still
  carry the #journal section.
- The ente post's [rss feed] link was root-relative, which lychee can't
  resolve in a markdown file; use the absolute feed URL.
- onelogin's OIDC-vs-SAML page answers non-browsers with an AWS WAF
  202 challenge but is alive; exclude it.
- docs/blog/codes/2024/0012/ holds sample app pages whose root-relative
  links only resolve when served; exclude the path.
@meysam81
meysam81 merged commit a5c87fb into main Nov 3, 2026
9 checks passed
@meysam81
meysam81 deleted the fix/lychee-dead-links branch November 3, 2026 10:03
@github-actions

github-actions Bot commented Nov 3, 2026

Copy link
Copy Markdown
Contributor

Live preview

Last updated: 2026-11-03T10:05:51
Last commit: 27d6f2d
The live preview of the changes are available at the following URL:
https://6ae9b1fc38b60fd6263e6831--developer-friendly.netlify.app

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