hermes - 💡(How to fix) Fix docs: three broken `/docs/...` links across the docs site

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Fix Action

Fix

# 1. cron-script-only: features/webhooks → messaging/webhooks
sed -i '' 's|/docs/user-guide/features/webhooks|/docs/user-guide/messaging/webhooks|g' \
  website/docs/guides/cron-script-only.md

# 2. atropos-environments: skills/bundled/mlops → skills/optional/mlops
sed -i '' 's|/docs/user-guide/skills/bundled/mlops/|/docs/user-guide/skills/optional/mlops/|g' \
  website/docs/user-guide/skills/optional/mlops/mlops-hermes-atropos-environments.md

Impact: navigation only — each broken link drops the reader on the docs 404 page.

Code Example

# 1. cron-script-only: features/webhooks → messaging/webhooks
sed -i '' 's|/docs/user-guide/features/webhooks|/docs/user-guide/messaging/webhooks|g' \
  website/docs/guides/cron-script-only.md

# 2. atropos-environments: skills/bundled/mlops → skills/optional/mlops
sed -i '' 's|/docs/user-guide/skills/bundled/mlops/|/docs/user-guide/skills/optional/mlops/|g' \
  website/docs/user-guide/skills/optional/mlops/mlops-hermes-atropos-environments.md
RAW_BUFFERClick to expand / collapse

Problem

Three internal links point to pages that don't exist at the linked path — two reference the wrong section, one references the wrong tier directory. All produce 404s in the rendered Docusaurus site.

1. cron-script-only.md → webhooks page in the wrong section

  • File: website/docs/guides/cron-script-only.md
  • Lines: 236 and 244
  • Bad link: /docs/user-guide/features/webhooks
  • Real file: website/docs/user-guide/messaging/webhooks.md/docs/user-guide/messaging/webhooks

2. mlops-hermes-atropos-environments.mdbundled/ instead of optional/

  • File: website/docs/user-guide/skills/optional/mlops/mlops-hermes-atropos-environments.md
  • Line: 24 (two links on the same line)
  • Bad links:
    • /docs/user-guide/skills/bundled/mlops/mlops-training-axolotl
    • /docs/user-guide/skills/bundled/mlops/mlops-training-trl-fine-tuning
  • Real files live under skills/optional/mlops/, not skills/bundled/mlops/:
    • website/docs/user-guide/skills/optional/mlops/mlops-training-axolotl.md
    • website/docs/user-guide/skills/optional/mlops/mlops-training-trl-fine-tuning.md

Repro

  1. cd website && npm install && npm start
  2. Open the three pages above and click each link — each lands on the docs 404.

Fix

# 1. cron-script-only: features/webhooks → messaging/webhooks
sed -i '' 's|/docs/user-guide/features/webhooks|/docs/user-guide/messaging/webhooks|g' \
  website/docs/guides/cron-script-only.md

# 2. atropos-environments: skills/bundled/mlops → skills/optional/mlops
sed -i '' 's|/docs/user-guide/skills/bundled/mlops/|/docs/user-guide/skills/optional/mlops/|g' \
  website/docs/user-guide/skills/optional/mlops/mlops-hermes-atropos-environments.md

Impact: navigation only — each broken link drops the reader on the docs 404 page.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

hermes - 💡(How to fix) Fix docs: three broken `/docs/...` links across the docs site