Skip to content

docs: fix broken troubleshooting anchor in Anthropic provider page#42297

Open
angrybirddd wants to merge 1 commit intoopenclaw:mainfrom
angrybirddd:fix/docs-anthropic-broken-anchor
Open

docs: fix broken troubleshooting anchor in Anthropic provider page#42297
angrybirddd wants to merge 1 commit intoopenclaw:mainfrom
angrybirddd:fix/docs-anthropic-broken-anchor

Conversation

@angrybirddd
Copy link
Copy Markdown
Contributor

Summary

  • Problem: The Anthropic provider page links to /gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription, but that anchor does not exist in the restructured troubleshooting page.
  • Why it matters: Readers clicking the link land at the top of the troubleshooting page with no matching section.
  • What changed: Removed the stale anchor fragment from the troubleshooting link in both EN and zh-CN Anthropic provider docs.
  • What did NOT change (scope boundary): No content removed — the inline fix advice ("re-auth with a setup-token") and the page's own Troubleshooting section are untouched.

Change Type (select all)

  • Docs

Scope (select all touched areas)

  • UI / DX

Linked Issue/PR

None — discovered during docs review.

User-visible / Behavior Changes

Troubleshooting link in Anthropic provider docs now correctly navigates to the troubleshooting page instead of a non-existent anchor.

Security Impact (required)

  • New permissions/capabilities? No
  • Secrets/tokens handling changed? No
  • New/changed network calls? No
  • Command/tool execution surface changed? No
  • Data access scope changed? No

Repro + Verification

Steps

  1. Open https://docs.openclaw.ai/providers/anthropic
  2. Scroll to "Notes" section
  3. Click the "Troubleshooting" link in the OAuth bullet
    Before: lands on troubleshooting page top, anchor not found.
image

After: lands on troubleshooting page (intentional, section was removed in restructure).
image

Evidence

  • Trace/log snippets

Target page headings (no oauth-token-refresh-failed anchor exists):
## Command ladder, ## Anthropic 429 extra usage required for long context, ## No replies, ## Dashboard control ui connectivity, ## Gateway service not running, ## Channel connected messages not flowing, ...

Human Verification (required)

  • Verified scenarios: Confirmed the anchor target does not exist in docs/gateway/troubleshooting.md by checking all headings. Confirmed the same page already has a working /gateway/troubleshooting link at line 231 without the anchor.
  • Edge cases checked: ja-JP has no providers/anthropic.md, so only EN and zh-CN need fixing.
  • What you did not verify: Did not run full docs site link checker.

Compatibility / Migration

  • Backward compatible? Yes
  • Config/env changes? No
  • Migration needed? No

Failure Recovery (if this breaks)

  • How to disable/revert this change quickly: Revert this single commit.
  • Files/config to restore: docs/providers/anthropic.md, docs/zh-CN/providers/anthropic.md
  • Known bad symptoms reviewers should watch for: None expected.

Risks and Mitigations

None.

@openclaw-barnacle openclaw-barnacle bot added docs Improvements or additions to documentation size: XS labels Mar 10, 2026
@greptile-apps
Copy link
Copy Markdown
Contributor

greptile-apps bot commented Mar 10, 2026

Greptile Summary

This PR fixes two broken anchor links in the Anthropic provider documentation (EN and zh-CN). The old links pointed to /gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription, an anchor that no longer exists after the troubleshooting page was restructured. The fix removes the stale fragment so both links now resolve to /gateway/troubleshooting without a 404-style anchor miss.

  • Verified the anchor oauth-token-refresh-failed-anthropic-claude-subscription does not appear anywhere in docs/gateway/troubleshooting.md.
  • Change is minimal, scoped to exactly two lines (one per locale), and all surrounding content is untouched.
  • ja-JP locale correctly has no providers/anthropic.md and therefore requires no change.

Confidence Score: 5/5

  • This PR is safe to merge — it is a minimal, correct docs-only fix with no logic or behavior changes.
  • The anchor target was verified to not exist in the troubleshooting page. Removing it is the appropriate fix. The change touches only two documentation lines across two locale files, with no risk of regression.
  • No files require special attention.

Last reviewed commit: 129fdbe

@angrybirddd angrybirddd force-pushed the fix/docs-anthropic-broken-anchor branch from 129fdbe to eff92b5 Compare March 10, 2026 15:51
@angrybirddd
Copy link
Copy Markdown
Contributor Author

Did a force-pushed to update the wrong Author and Email address :)

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

Labels

docs Improvements or additions to documentation size: XS

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant