Skip to content

📖 docs: fix six 404 links in the GPU and CUDA guide - #786

Open
hanthor-hive-agent[bot] wants to merge 2 commits into
mainfrom
guide/docs-gpu-guide-links
Open

hanthor-hive-agent[bot] wants to merge 2 commits into
mainfrom
guide/docs-gpu-guide-links

Conversation

@hanthor-hive-agent

@hanthor-hive-agent hanthor-hive-agent Bot commented Nov 20, 2026 •

Copy link
Copy Markdown
Contributor

Documentation Fix

#776 added docs/gpu-cuda-setup-guide.md with six links that have no /docs prefix. Docs are served under /docs, so on tunaos.org each link goes to a 404: /choosing-a-variant, /bootc-rollback, /layering, /guides/AI-DEVELOPMENT-QUICKSTART, /system-requirements, /secure-boot. I checked each with curl. The /docs/... form of each returns 200.

This PR changes them to relative .md links, which is what performance-tuning-power-management.md uses. That has two benefits: Docusaurus resolves the links to the right route, and the link-check job now verifies them. It skipped them before because they did not end in .md. The [Albacore](/albacore) link stays as it is: src/pages/albacore.tsx serves it, and it returns 200.

Why it matters beyond this page: on main, npx docusaurus build reports these six links as the only broken links on the whole site. With this change it reports none. That makes onBrokenLinks: "throw" (the scope approved on #410) safe to turn on.

Fixes #785. This PR does the link part only. The docusaurus.config.ts change (onBrokenLinks, then onBrokenAnchors, to throw) is site configuration, outside this docs-only lane, so #785 stays open for it.

Checks run locally:


Filed by guide agent (ACMM L6 — full mode)

— hive: agent=guide backend=claude model=claude-opus-5-5 effort=high claude=2.1.322

The guide linked to doc routes without the /docs prefix, so each link
went to a 404 on tunaos.org. Use relative .md links, which Docusaurus
resolves and the link-check job verifies.

Refs #785

Signed-off-by: guide <290068839+hanthor-hive-agent[bot]@users.noreply.github.com>
@github-actions
github-actions Bot removed the request for review from hanthor November 20, 2026 01:44
@hanthor-hive-agent hanthor-hive-agent Bot added author/hive This repository's own hive (the App or one of its agent lanes) authored this PR dco All commits are DCO signed-off role/trusted Author is trusted for unattended merge (trusted-author role or registry/claim tier in require_tiers) stage/070-fixing Hive-authored PR: CI red, changes requested or needs rebase; a hive agent is fixing it labels Nov 20, 2026
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 20, 2026 •

Copy link
Copy Markdown

Deploying with  Cloudflare Workers  Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status Name Latest Commit Preview URL Updated (UTC)
✅ Deployment successful!
View logs
tunaos-org 281c742 Commit Preview URL

Branch Preview URL
Nov 20 2026, 04:33 AM

@hanthor-hive-agent

Copy link
Copy Markdown
Contributor Author

The red Node.js Syntax & Tests check does not come from this diff. Its check-install-commands step fails on missing Homebrew formula/cask: bluefin-cli [ublue-os/homebrew-experimental-tap] in docs/bluefin-cli/{index,setup-macos,setup-linux}.md. main has the same failure since #784 (run 44643447605). The cause: on 2026-11-19 the experimental tap deleted bluefin-cli.rb.

These pages sync from tuna-os/bluefin-cli, so a fix made here would be reverted. The fix is in tuna-os/bluefin-cli#520 (Fixes tuna-os/bluefin-cli#519). After it merges and the next org docs sync runs, this check goes green, and this PR can re-run without changes.


🐝 Hive Agent: guide | Instance: school | SHA: unknown

— hive: agent=guide backend=claude model=claude-opus-5-5 effort=high claude=2.1.322

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author/hive This repository's own hive (the App or one of its agent lanes) authored this PR dco All commits are DCO signed-off role/trusted Author is trusted for unattended merge (trusted-author role or registry/claim tier in require_tiers) stage/070-fixing Hive-authored PR: CI red, changes requested or needs rebase; a hive agent is fixing it

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[guide] Docusaurus build still warns on broken links: #410's approved onBrokenLinks: throw never landed

1 participant