docs(openapi): fix 4 broken docs.bitbadges.io URLs (#0291)#212
Merged
docs(openapi): fix 4 broken docs.bitbadges.io URLs (#0291)#212
Conversation
The hand-written route descriptions linked to pages that have since moved or been removed in the docs reorg. All four still 404 today (verified via curl). Most other previously-broken links from ticket #0291 (managing-views, dynamic-stores, sign-in-with-bitbadges, create-and-broadcast-txs, /claims) now 200 thanks to Gitbook redirects + earlier doc-watch sweeps — only these four remain. Fixes: - Drop "Native Chain Algorithm" bullet on the GET-account route. The page no longer exists; the only equivalent (concepts/accounts.md) isn't in SUMMARY.md so it's not published. The "Couple Notes:" header it introduced went with it. - "Codes Plugin" link → /claims/built-in-plugins (covers Codes alongside the other built-in plugins). - "Getting Claims" / "Managing Claims" tutorial bullets → updated to /claims/api-reference + /claims/designing-claims, the post-reorg homes for that content. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Fixes the four
docs.bitbadges.ioURLs inpackages/bitbadgesjs-sdk/openapitypes-helpers/routes.yamlthat still 404 today. Closes autopilot ticket #0291.What changed
/for-developers/bitbadges-api/concepts/native-chain-algorithm/for-developers/claim-builder/universal-approach-claim-codes/for-developers/claims/built-in-plugins/for-developers/bitbadges-api/tutorials/getting-claims/for-developers/claims/api-reference/for-developers/bitbadges-api/tutorials/managing-claims/for-developers/claims/designing-claimsThe other links the ticket flagged (
/claims,/sign-in-with-bitbadges,/create-and-broadcast-txs,/concepts/managing-views,/claims/dynamic-stores) all return 200 today thanks to Gitbook redirects + earlier doc-watch sweeps — left untouched.Why "Native Chain Algorithm" was dropped
The page no longer exists. The closest content is in
for-developers/concepts/accounts.md, but that file isn't referenced inSUMMARY.mdso Gitbook doesn't publish it (/for-developers/concepts/accountsalso 404s). Rather than point users at unpublished content, dropped the bullet entirely. TheCouple Notes:header that introduced it went with it since it was the only bullet.Test plan
grepconfirms none of the original 9 broken-URL patterns remain inroutes.yaml.Follow-up (out of scope)
The ticket's bonus ask — "add a CI check that runs curl against each
docs.bitbadges.ioURL in the spec and fails on 404" — would prevent this from regressing. Worth its own PR; touching.github/workflows/is broader than this docs swap.🤖 Generated with Claude Code