Skip to content

improve lychee config (again), fix links in customize section#470

Merged
avanscoy merged 3 commits intomainfrom
chore/fix-links-lychee-improvements
Jan 14, 2026
Merged

improve lychee config (again), fix links in customize section#470
avanscoy merged 3 commits intomainfrom
chore/fix-links-lychee-improvements

Conversation

@hazel-nut
Copy link
Copy Markdown
Contributor

@hazel-nut hazel-nut commented Jan 13, 2026

description

this PR tweaks the newly-improved lychee config:

  • stops accepting 302, 307, 403, and 429 by default because doing so loses signal on actual broken links.
  • adds additional domains that throw errors not related to broken links, like npmjs aggressively 403ing all bots and anchor links on dynamic pages.
  • changes cache to only store successful status code responses to avoid re-testing known valid links while fixing links locally

and then i fixed all the links in the /customize section of the docs. 🙂

testing

one test is the results of lychee on this PR! unfortunately the salesforce links sometimes redirect with language locale and then sometimes also redirect back ... not sure what to do about that.

you can also test by running lychee locally against the customize section. from the root of the repo:

lychee -c lychee.toml main/docs/customize/**/*.mdx

you'll probably see a few 503s from core.telegram.org because okta blocks the domain (but the URLs do work). you'll also see a 404 for the auth0-aws github repo, but there's no replacement link because the repo was deleted. i erred on the side of not deprecating a half dozen content articles in this PR to avoid scope creep, but we probably should.

@hazel-nut hazel-nut added the MERGE-ON-APPROVAL Approving reviewer should merge. label Jan 13, 2026
@hazel-nut hazel-nut changed the title Chore/fix links lychee improvements improve lychee config (again), fix links in customize section Jan 13, 2026
@github-actions
Copy link
Copy Markdown

github-actions bot commented Jan 13, 2026

Summary

Status Count
🔍 Total 402
✅ Successful 147
⏳ Timeouts 0
🔀 Redirected 3
👻 Excluded 251
❓ Unknown 0
🚫 Errors 0
⛔ Unsupported 1

Redirects per input

Redirects in main/docs/customize/integrations/marketing-tool-integrations/salesforce-marketing-cloud.mdx

@hazel-nut
Copy link
Copy Markdown
Contributor Author

hazel-nut commented Jan 13, 2026

oops. all the auth0.com/docs link barking should quiet down once #370 is in. but i've temporarily excluded it in 9bc189e and will remove that exclusion in the other PR.

Comment thread lychee.toml
Comment thread lychee.toml
@avanscoy avanscoy merged commit 847ff08 into main Jan 14, 2026
4 of 5 checks passed
@avanscoy avanscoy deleted the chore/fix-links-lychee-improvements branch January 14, 2026 19:53
daniloasis-auth0 pushed a commit to daniloasis-auth0/docs-v2 that referenced this pull request Jan 23, 2026
)

* update lychee config to remove unnecessary error exclusions and add specific domain exclusions, plus better caching

* fix all the links in the customize section

* temporarily exclude auth0.com/docs/
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

MERGE-ON-APPROVAL Approving reviewer should merge.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants