Skip to content

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

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

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 :)

@steipete
Copy link
Copy Markdown
Contributor

Closing this as implemented after Codex review.

Current main already supersedes this docs-only PR: the Anthropic provider page was rewritten, the stale troubleshooting anchor no longer exists anywhere under docs/, and the repo no longer carries localized docs in docs/<locale>/**.

What I checked:

  • Current Anthropic doc no longer uses the stale anchor: docs/providers/anthropic.md now has its own troubleshooting section and a generic help note linking to /help/troubleshooting and /help/faq, with no /gateway/troubleshooting#oauth-token-refresh-failed-anthropic-claude-subscription link. (docs/providers/anthropic.md:277, 4737a86071e3)
  • Broken anchor string is gone from current docs tree: A repo search for oauth-token-refresh-failed-anthropic-claude-subscription under docs/ returned no matches, so the reported broken anchor is not present on current main. (7d9172d5e093)
  • Current troubleshooting page is a new runbook, not the old anchor target: docs/gateway/troubleshooting.md on current main is a newly created troubleshooting runbook with sections like ## Command ladder and ## Anthropic 429 extra usage required for long context; the old anchor target from the PR body is not part of this page. (docs/gateway/troubleshooting.md:14, 4737a86071e3)
  • Localized doc path from the PR is obsolete in this repo: The docs guide now states that foreign-language docs are not maintained in this repository and docs/<locale>/** should not be edited here, which matches the absence of docs/zh-CN/providers/anthropic.md on current main. Public docs: docs/AGENTS.md. (docs/AGENTS.md:21, 7d9172d5e093)

So I’m closing this as already implemented rather than keeping a duplicate issue open.

Review notes: reviewed against 7d9172d5e093; fix evidence: commit 4737a86071e3.

@steipete steipete closed this Apr 25, 2026
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.

2 participants