Skip to content

[docs-agent] Update wallets CONTRIBUTING.md to require /docs/ prefix on relative links#1269

Merged
SahilAujla merged 1 commit intomainfrom
docs/contributing-md-docs-prefix
Apr 27, 2026
Merged

[docs-agent] Update wallets CONTRIBUTING.md to require /docs/ prefix on relative links#1269
SahilAujla merged 1 commit intomainfrom
docs/contributing-md-docs-prefix

Conversation

@JackReacher0807
Copy link
Copy Markdown
Collaborator

Summary

The wallets contributor guide previously instructed writers to begin relative links with /wallets/..., which was the source of repeated lychee CI failures. Links missing the /docs/ prefix render fine on the live site thanks to URL-handling fallback, but the lychee link checker (run on every PR) treats them as broken and fails CI.

This PR updates content/wallets/CONTRIBUTING.md in two places:

  • Section 4 (Content Organization → Link Strategy): change the relative-link example from /wallets/... to /docs/wallets/... and add a one-line note explaining why the /docs/ prefix is required.
  • Section 6 (Markdown Formatting Standards → Links and References): change the example [/wallets/authentication] to [/docs/wallets/authentication] so the bullet matches the new rule.

This is purely a guideline correction. No other content changes. The link instances themselves were already fixed across MDX files in #1267.

Linear

DOCS-68 — https://linear.app/alchemyapi/issue/DOCS-68/prepend-docs-to-wallet-links-breaking-lychee-link-checker

Requested by

@SahilAujla (via Slack thread)

…on relative links

The previous wording told contributors to begin relative links with /wallets/..., which is the source of repeated regressions: links missing the /docs/ prefix render fine on the live site (URL-handling fallback) but fail the lychee link checker, blocking CI on every PR.

Updates two locations in content/wallets/CONTRIBUTING.md to use /docs/wallets/... and adds a brief note explaining why the prefix is required. Mirrors the link-fix pattern landed in PR #1267.

Refs DOCS-68

Requested-by: @SahilAujla
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 27, 2026

🔗 Preview Mode

Name Status Preview Updated (UTC)
Alchemy Docs ✅ Ready 🔗 Visit Preview Apr 27, 2026, 4:36 PM

@SahilAujla SahilAujla merged commit 086fffb into main Apr 27, 2026
13 of 14 checks passed
@SahilAujla SahilAujla deleted the docs/contributing-md-docs-prefix branch April 27, 2026 16:37
@github-actions
Copy link
Copy Markdown

🔍 Link Check

Status: ❌ Failed

Summary

Status Count
🔍 Total 8012
✅ Successful 6867
⏳ Timeouts 0
🔀 Redirected 459
👻 Excluded 676
❓ Unknown 0
🚫 Errors 9
⛔ Unsupported 1
Broken links (9) — click to expand

Errors per input

Errors in ./content/api-reference/base/base-api-faq.mdx

Errors in ./content/tutorials/snapshots/aptos.mdx

Errors in ./content/wallets/wallet-integrations/privy/jwt-auth-migration.mdx

Errors in ./content/tutorials/snapshots/avalanche.mdx

Errors in ./content/wallets/pages/recipes/onramp-funds.mdx

Errors in ./content/wallets/wallet-integrations/privy/signer-migration-overview.mdx

Errors in ./content/api-reference/arbitrum-nova/arbitrum-nova-deprecation-notice.mdx

Errors in ./content/tutorials/smart-wallets/learn-account-abstraction/introduction-to-account-abstraction.mdx

View workflow run

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants