Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Bug] Link checking does not work during CI #671

Open
yurishkuro opened this issue Feb 2, 2024 · 0 comments
Open

[Bug] Link checking does not work during CI #671

yurishkuro opened this issue Feb 2, 2024 · 0 comments

Comments

@yurishkuro
Copy link
Member

I disabled it for now in #670. When link checker was enabled, it was failing, e.g.:

bin/htmltest
htmltest started at 11:25:26 on public
========================================================================
index.html
  src attribute empty --- index.html --> 
  src attribute empty --- index.html --> 
...
  src attribute empty --- index.html --> 
  src attribute empty --- index.html --> 
========================================================================
✘✘✘ failed in 1.710136092s
10 errors in 920 documents
make: *** [Makefile:55: run-link-checker] Error 1
  1. unhelpful since it does not say where in the index.html it thinks the issue is, and
  2. it's not actually checking the links correctly:
    * to check internal links only it needs to run with -s flag
    * for some reason we have make target for checking external links as well which passes a config file, why isn't the same config used for internal links?
    * when I did run it with -s, I saw a bunch of "skipping external check" for URLs that are actually to jaegertracing.io, probably because Hugo generates them this way and the checker treats them as external (perhaps there's a way to specify this in the configuration)
    * meanwhile checking external links doesn't work at all as many websites appear to throttle bots

Proposal

Need to investigate if this checker is the best tool we can use (may want to check OTEL website). If it is, then maybe there are configuration options for it to not skip our own domain (not sure how that would work as the checks are meant to be against local paths). Or perhaps we could tweak our Hugo config to not generate absolute URLs and always use relative ones.

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

No branches or pull requests

1 participant