[docs-agent] Add Swap tokens section to wallets nav to fix live 404s

[alchemy-bot]

Summary

Follow-up on the Slack thread: the same-chain Swap API is NOT deprecated (@jakehobbs confirmed it's been live for all teams since Oct 2025, ~16 teams using it in the past week). The actual bug @kennethngo-alch reported is that /docs/wallets/transactions/swap-tokens and /docs/wallets/transactions/cross-chain-swap-tokens both return 404 on the live site.

Root cause: the two MDX files exist on disk at content/wallets/pages/transactions/swap-tokens/index.mdx and content/wallets/pages/transactions/cross-chain-swap-tokens/index.mdx, but neither is registered in content/docs.yml, so Fern doesn't route to them even though inbound links (wallets index card, transactions overview table, React quickstart bullet, cross-chain guide inline reference) all point at those URLs.

Verified against live:

GET /docs/wallets/transactions/retry-transactions         → HTTP 200  (in docs.yml)
GET /docs/wallets/transactions/send-parallel-transactions → HTTP 200  (in docs.yml)
GET /docs/wallets/transactions/pay-gas-with-any-token     → HTTP 200  (in docs.yml)
GET /docs/wallets/transactions/swap-tokens                → HTTP 404  (NOT in docs.yml)
GET /docs/wallets/transactions/cross-chain-swap-tokens    → HTTP 404  (NOT in docs.yml)

Fix

Added a Swap tokens subsection under Wallets > Transactions in content/docs.yml, placed right after Send transactions, with two child pages (Same-chain swaps, Cross-chain swaps) mapped to the existing MDX files. No content edits — just nav registration.

Diff

+          - section: Swap tokens
+            contents:
+              - page: Same-chain swaps
+                path: wallets/pages/transactions/swap-tokens/index.mdx
+              - page: Cross-chain swaps
+                path: wallets/pages/transactions/cross-chain-swap-tokens/index.mdx

History

Original PR intent (removing all inbound links) was based on Ava's initial "yes deprecated" note. That was reversed later in the thread once @jakehobbs shared usage numbers, so the removal commit has been force-pushed away and this PR now instead unblocks the 404s.

Requested by

@dslovinsky (via Slack thread)

[github-actions]

🔗 Preview Mode

Name	Status	Preview	Updated (UTC)
Alchemy Docs	✅ Ready	🔗 Visit Preview	Sep 23, 2026, 10:17 PM

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: b0e79ce26f

ℹ️ About Codex in GitHub

Codex has been enabled to automatically review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

When you sign up for Codex through ChatGPT, Codex can also answer questions or update the PR, like "@codex address that feedback".

@dslovinsky you are listed as the originator of this docs request (via the Requested-by trailer on a docs-agent commit). Per the docs-agent self-review policy, the originator can't approve their own request. Please ask another team member to review.