Skip to content

Fix broken support links (bluetooth, webcam, UN3481 PDF) and redirect /steam - #1412

Merged
erinxocon merged 11 commits into
masterfrom
fix/stale-support-links
Nov 5, 2026
Merged

erinxocon merged 11 commits into
masterfrom
fix/stale-support-links

Conversation

@erinxocon

Copy link
Copy Markdown
Member

Fixes 6 URLs that the Ahrefs Site Audit reports as 404.

Changes

  • bluetooth: other-accounts and live-disk are sibling articles, so the links need ../. ./other-accounts/index.md didn't resolve to a file, so the link plugin skipped it and the raw .md href shipped.
  • setup-face-recognition: /content/webcam.md is root-absolute, which the link plugin ignores. It now links ../webcam/index.md.
  • reboxing: PDFs under src/content aren't published, so the UN3481 battery label link 404ed. The PDF moves to public/pdfs/ and the link points at /support/pdfs/Li-Battery-Label-UN3481.pdf. The file is still an LFS pointer to the same object as before.
  • steam: old /support/articles/steam links are rewritten to /support/steam by the CloudFront function, but there is no Steam article any more. Adds an Astro redirect from /steam to /support/linux-gaming.

Testing

pnpm build builds 145 pages. In dist/:

  • no .md/.mdx hrefs remain, apart from 3 external GitHub links
  • every internal /support/ link resolves
  • the PDF is in dist/pdfs/
  • dist/steam/index.html redirects to /support/linux-gaming

They are sibling articles, so the relative paths need ../ to resolve.
The root-absolute /content/webcam.md link was never rewritten, use a relative path to the article instead.
PDFs under src/content are not published, so the link 404ed. Move it to public/pdfs and link it from there.
Old /support/articles/steam links end up at /support/steam, which no longer exists.
The images used root-absolute /images/... paths from the old site and 404ed. Use the article's relative img/ paths like other articles.
/pop/download/ is a redirect to /download-pop/.
/pop/download/ is a redirect to /download-pop/.
/pop/download/ is a redirect to /download-pop/.
The old support.system76.com/articles/live-disk link redirects twice before reaching the article.
The link text still showed the old support.system76.com/articles/ URLs, the hrefs were already correct.

@thomas-zimmerman thomas-zimmerman left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@erinxocon
erinxocon merged commit da7b6ff into master Nov 5, 2026
2 checks passed
@erinxocon
erinxocon deleted the fix/stale-support-links branch November 5, 2026 20:25
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.

2 participants