Skip to content

Fix dead tutorial links flagged by link-rot audit - #5264

Open
jeremyrose-viam wants to merge 1 commit into
viamrobotics:mainfrom
jeremyrose-viam:fix-tutorial-dead-links
Open

Fix dead tutorial links flagged by link-rot audit#5264
jeremyrose-viam wants to merge 1 commit into
viamrobotics:mainfrom
jeremyrose-viam:fix-tutorial-dead-links

Conversation

@jeremyrose-viam

Copy link
Copy Markdown
Contributor

Summary

Fixes #5196 (recurring run-htmltest-external CI failure on the Amazon 24V
power supply link in claw-game.md), plus three more dead links found while
looking into that same tutorial and running a one-off link audit:

  • docs/tutorials/projects/claw-game.md: replaced the dead Amazon 24V power
    supply link and the dead eBay arcade-claw link (auction had ended; not
    caught by CI because ebay.com is in .htmltest.yml's IgnoreURLs).
  • docs/tutorials/projects/integrating-viam-with-openai.md: replaced a dead
    ElevenLabs auth-docs link with the ElevenLabs dashboard API-keys page
    (added elevenlabs.io/app to .htmltest.yml's ignore list, since it's an
    authenticated client-rendered SPA that a plain HTTP check can't verify
    either way — same reasoning as the existing app.viam.com entry). Also
    swapped a dead Fandom wiki link for a Wikipedia one in the same file.

All four pre-PR checks (prettier, markdownlint, vale, make build-prod)
pass clean.

Context

While fixing the CI-flagged Amazon link, noticed the eBay link on the same
page was also dead but invisible to CI (ignore-listed domain), which raised
a bigger question about the amount of unmaintained tutorial content in this
repo. Wrote a quick audit script to check every external link under
docs/tutorials/ (not just what htmltest is willing to check) against
.htmltest.yml's ignore list — it's on a separate branch,
add-tutorial-link-audit-script,
not included in this PR since we're not adding it to the repo at this time.
Running it against all tutorials turned up the 3 additional dead links fixed
here; everything else checked out clean.

@netlify

netlify Bot commented Aug 14, 2026

Copy link
Copy Markdown

Deploy Preview for viam-docs ready!

Name Link
🔨 Latest commit 78c18e1
🔍 Latest deploy log https://app.netlify.com/projects/viam-docs/deploys/6a7f5c283a764a00080a7e7e
😎 Deploy Preview https://deploy-preview-5264--viam-docs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
1 paths audited
Performance: 37 (🔴 down 9 from production)
Accessibility: 100 (no change from production)
Best Practices: 100 (🟢 up 8 from production)
SEO: 92 (no change from production)
PWA: 60 (no change from production)
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@viambot viambot added the safe to build This pull request is marked safe to build from a trusted zone label Aug 14, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

safe to build This pull request is marked safe to build from a trusted zone

Projects

None yet

Development

Successfully merging this pull request may close these issues.

CI failure: run-htmltest-external

2 participants