docs: fix broken links surfaced by linkinator - #262
Merged
Conversation
Replaces dead URLs reported by the Check Broken Links workflow: - quick-start.md: dead staging-docs.atalaprism.io tutorial link → local /documentation/learn/advanced-explainers/did-prism/ - develop/cloud-agent/authentication.md: 3× dead staging-docs ADR URLs → corresponding local /documentation/adrs/decisions/ pages; Keycloak securing_apps#_token-exchange (404) → securing-apps/ token-exchange - reference/specifications.md: OID4VP draft URL was renamed by the OpenID Foundation, openid-4-verifiable-credential-presentation → openid-4-verifiable-presentations - ADR 2022-10-05 (tapir): removed gone Google Doc + collapsed tapir goals.html (404) into tapir.softwaremill.com root - ADR 2022-10-06 (private keys): removed 404 Google Drive link, kept the text - ADR 2023-04-05 (DID-linked resources): w3c-ccg.github.io/ did-resolution → w3.org/TR/did-resolution; removed 404 docs.trinsic.id template-service link - ADR 2023-09-26 (wallet permissions): Keycloak docs/22.0.0/ authorization_services → docs/latest/ (5 occurrences) - ADR 2024-05-20 (DID URLs for resources): w3c-ccg.github.io/ did-resolution → w3.org/TR/did-resolution Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com> Signed-off-by: Yurii Shynbuiev <yurii.shynbuiev@iohk.io>
🦙 MegaLinter status: ✅ SUCCESS
See detailed report in MegaLinter reports MegaLinter is graciously provided by |
|
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
Repairs the real broken links (404 / dead-DNS / 410) that the Check Broken Links workflow reported in run 26278275914. Pairs with #261 which stabilizes the link-check job itself.
Categories of fix:
staging-docs.atalaprism.ioreferences (DNS gone) → repointed to the equivalent local pages under/documentation/adrs/decisions/and/documentation/learn/...openid-4-verifiable-presentations-1_0.htmldocs/22.0.0/authorization_services→docs/latest/authorization_services;securing_apps#_token-exchange→securing-apps/token-exchangew3c-ccg.github.io/did-resolution(404) →w3.org/TR/did-resolution(the published W3C version)ADRs are treated as updatable in this PR (per user direction).
Auto-generated
documentation/reference/Cloud Agent API/*.api.mdxfiles were intentionally not touched — the deadw3c-ccg.github.io/did-resolutionreferences in them come from the cloud-agent submodule's OpenAPI spec and will re-appear on everygen-api-docs. That URL is skipped at the linkinator level in #261.Test plan
npm run build) and confirm no Docusaurus broken-link errors for the changed pages🤖 Generated with Claude Code