Rewrite docs style guide

[SahilAujla]

Summary

• replace the rushed style rules with a structured docs style guide
• add agent-optimized quick rules for AI contributors
• document changelog conventions and MDX Steps guidance
• rewrite four representative tutorials as a first-pass eval set

Review these rewritten pages

• Create an Alchemy API key
• Make your first Alchemy request
• How to make HTTP header-based API requests
• How to check a transaction status from its hash

Questions for review

• Does the first screen make the page outcome obvious?
• Are prerequisites explicit without slowing the page down?
• Do the steps stay focused on actions instead of mixing in too much background?
• Are the code samples easier to copy, trust, and adapt?
• Does the tone feel consistent across different doc types?
• Would you want future rewrites to follow this pattern?

[github-actions]

🔗 Preview Mode

Name	Status	Preview	Updated (UTC)
Alchemy Docs	✅ Ready	🔗 Visit Preview	Mar 6, 2026, 5:46 PM

[github-actions]

🔍 Link Check

Status: ❌ Failed

Summary

Status	Count
🔍 Total	6945
✅ Successful	5932
⏳ Timeouts	0
🔀 Redirected	381
👻 Excluded	612
❓ Unknown	0
🚫 Errors	20
⛔ Unsupported	0

Broken links (20) — click to expand

Errors per input

Errors in ./content/wallets/pages/react/add-passkey.mdx

• [404] https://docs-lilac-beta.vercel.app/wallets/react/setup | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/wallets/react/login-methods/passkey-login | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/wallets/react/quickstart | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/wallets/signer/authentication/adding-and-removing-login-methods | Rejected status code: 404 Not Found (configurable with "accept" option)

Errors in ./content/api-reference/arbitrum/arbitrum-api-faq/arbitrumethereum-differences.mdx

• [429] https://developer.offchainlabs.com/arbos/l1-pricing | Rejected status code: 429 Too Many Requests (configurable with "accept" option)
• [429] https://developer.offchainlabs.com/time | Rejected status code: 429 Too Many Requests (configurable with "accept" option)
• [429] https://developer.offchainlabs.com/solidity-support | Rejected status code: 429 Too Many Requests (configurable with "accept" option)
• [429] https://developer.offchainlabs.com/arbos/l1-to-l2-messaging#submitting-a-retryable | Rejected status code: 429 Too Many Requests (configurable with "accept" option)
• [429] https://developer.offchainlabs.com/arbos/common-precompiles | Rejected status code: 429 Too Many Requests (configurable with "accept" option)
• [429] https://developer.offchainlabs.com/arbos/precompiles#ArbAddressTable | Rejected status code: 429 Too Many Requests (configurable with "accept" option)
• [429] https://developer.offchainlabs.com/arbos/l1-to-l2-messaging#redeeming-a-retryable | Rejected status code: 429 Too Many Requests (configurable with "accept" option)
• [429] https://developer.offchainlabs.com/arbos/geth#transaction-types | Rejected status code: 429 Too Many Requests (configurable with "accept" option)
• [429] https://developer.offchainlabs.com/arbos/l1-to-l2-messaging#retryables | Rejected status code: 429 Too Many Requests (configurable with "accept" option)
• [429] https://developer.offchainlabs.com/arbos/l1-to-l2-messaging | Rejected status code: 429 Too Many Requests (configurable with "accept" option)
• [429] https://developer.offchainlabs.com/arbos/precompiles | Rejected status code: 429 Too Many Requests (configurable with "accept" option)

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

• [404] https://docs-lilac-beta.vercel.app/docs/chains/solana/solana-api-endpoints/simulate-transaction | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/solana/solana-api-endpoints/get-transaction | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/solana/solana-api-endpoints/get-health | Rejected status code: 404 Not Found (configurable with "accept" option)
• [404] https://docs-lilac-beta.vercel.app/docs/chains/solana/solana-api-endpoints/send-transaction | Rejected status code: 404 Not Found (configurable with "accept" option)

Errors in ./content/wallets/CONTRIBUTING.md

• [404] https://docs-lilac-beta.vercel.app/STYLE_RULES.md | Rejected status code: 404 Not Found (configurable with "accept" option)

View workflow run