cd /news/ai-tools/broken-navigation-links-404-errors-a… · home › topics › ai-tools › article
[ARTICLE · art-134359] src=discuss.huggingface.co ↗ pub= topic=ai-tools verified=true sentiment=↓ negative

Broken navigation links (404 errors) across the Agents Course due to /docs/ vs /learn/ pathsBody Text:

Hugging Face's Agents Course is suffering widespread 404 errors because internal platform links still point to the old /docs/agents-course/ paths after the site moved to /learn/agents-course/, according to a forum post that cites open GitHub issues #749 and #748. The post asks course maintainers, including @m-louise-blandin and @lysandre, to check the routing or merge path updates to fix the layout files, affecting "Next" buttons, sidebar links, and several notebook links.

read1 min views1 publishedSep 19, 2026

Hi everyone,

I am noticing a widespread issue with the new Agents Course navigation. Clicking the “Next” buttons, sidebar links, and several notebook links frequently leads to 404 pages.

Looking at the URLs, it seems the site structure recently changed to /learn/agents-course/, but many of the internal platform links are still hardcoded to point to the old /docs/agents-course/ paths.

There are already several open GitHub issues regarding this (such as #749 and #748). Could a course maintainer please check the routing or merge the necessary path updates to fix the layout files?

Thank you for your help!

cc course maintainers: @m-louise-blandin @lysandre

source & further reading
discuss.huggingface.co — original article Rakarrack-0.6.1 port making progress! ( AI assisted ) Cloud Storage Poll Welcome to Haiku basic(Haiku Docs, Haiku slide and Haiku sheets)
── more in #ai-tools 4 stories · sorted by recency
── more on @hugging face 3 stories trending now
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
→ Live at https://your-agent.zahid.host ✓
Get free account → Pricing
from €0/mo · no card required
LIVE [news/broken-navigation-li…] indexed:0 read:1min 2026-09-19 · —