From 9b1f647ebe6a96d7941af7e94c8708f68a4be448 Mon Sep 17 00:00:00 2001
From: Alexandra Carrillo <alexandra.carrillo@consensys.net>
Date: Tue, 18 Nov 2025 18:59:17 -0800
Subject: [PATCH 1/3] Update all CardList links to absolute and add guidance

---
 CONTRIBUTING.md                               | 39 ++++++++++++++++---
 developer-tools/dashboard/index.md            |  6 +--
 gator_versioned_docs/version-0.1.0/index.mdx  | 10 ++---
 gator_versioned_docs/version-0.13.0/index.md  |  8 ++--
 services/reference/arbitrum/index.md          |  4 +-
 services/reference/avalanche-c-chain/index.md |  4 +-
 services/reference/base/index.md              |  4 +-
 services/reference/blast/index.md             |  4 +-
 services/reference/bnb-smart-chain/index.md   |  4 +-
 services/reference/celo/index.md              |  4 +-
 services/reference/ethereum/index.md          |  4 +-
 services/reference/gas-api/index.md           |  4 +-
 services/reference/hemi/index.md              |  4 +-
 services/reference/ipfs/index.md              |  4 +-
 services/reference/linea/index.md             |  4 +-
 services/reference/mantle/index.md            |  4 +-
 services/reference/opbnb/index.md             |  4 +-
 services/reference/optimism/index.md          |  4 +-
 services/reference/palm/index.md              |  4 +-
 services/reference/polygon-pos/index.md       |  4 +-
 services/reference/scroll/index.md            |  4 +-
 services/reference/sei/index.md               |  4 +-
 services/reference/solana/index.md            |  4 +-
 services/reference/starknet/index.md          |  4 +-
 services/reference/swellchain/index.md        |  4 +-
 services/reference/unichain/index.md          |  4 +-
 services/reference/zksync/index.md            |  4 +-
 smart-accounts-kit/index.mdx                  | 10 ++---
 28 files changed, 96 insertions(+), 69 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 3da5ba2b586..b469a856f64 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -71,10 +71,10 @@ To contribute changes:
 
    > **Notes:**
    >
-   > - All documentation content is located in the `wallet`, `sdk`, `snaps`, `services`, and
-   >   `developer-tools` directories.
-   > - If you add a new documentation page, edit `wallet-sidebar.js`, `sdk-sidebar.js`, `snaps-sidebar.js`,
-   >   `services-sidebar.js`, or `dashboard-sidebar.js` to add the page to the
+   > - All documentation content is located in the `sdk`, `wallet`, `embedded-wallets`, `smart-accounts-kit`, `services`,
+   >   `developer-tools`, `snaps`, and `src/pages` directories.
+   > - If you add a new documentation page, edit `sdk-sidebar.js`, `wallet-sidebar.js`, `ew-sidebar.js`, `gator-sidebar.js`,
+   >   `services-sidebar.js`, `dashboard-sidebar.js`, or `snaps-sidebar.js` to add the page to the
    >   [sidebar](https://docs-template.consensys.io/create/configure-docusaurus#sidebar).
    > - If you delete, rename, or move a documentation file, add a
    >   [redirect](https://vercel.com/docs/edge-network/redirects#configuration-redirects).
@@ -116,10 +116,37 @@ To contribute changes:
 
 Refer to the [Consensys documentation style guide](https://docs-template.consensys.net/contribute/style-guide).
 
+## Format links
+
+Most links in the Markdown pages use *relative file paths*, for example:
+
+```md title="Relative file path in Smart Accounts Kit docs"
+You can enable users to create a [MetaMask smart account](../../concepts/smart-accounts.md) directly in your dapp.
+```
+
+However, when linking between different product sections or using the `CardList` component, use *absolute URL paths*. For example:
+
+```md title="Absolute URL path in Wallet API docs"
+When a dapp requests to submit a batch of transactions atomically, MetaMask may prompt users to upgrade their externally owned account (EOA) to a [MetaMask smart account](/smart-accounts-kit/concepts/smart-accounts).
+```
+
+```md title="Absolute URL path in Snaps docs"
+<CardList
+  items={[
+    {
+      href: '/snaps/learn/about-snaps',
+      title: 'About Snaps',
+      description: 'See a high-level, technical overview of the Snaps system.',
+    },
+    ...
+  ]}
+/>
+```
+
 ## Add images
 
-All images are located in the `wallet/assets`, `sdk/_assets`, `snaps/assets`, `services/images`, and
-`developer-tools/images` directories.
+All images are located in the `sdk/_assets`, `wallet/assets`, `smart-accounts-kit/assets`, `services/images`,
+`developer-tools/images`, `snaps/assets`, and `static/img` directories.
 When adding a new image, such as a screenshot or diagram, make sure the image has a white or
 `#1b1b1d` color background in order for it to be compatible with the site's light and dark modes.
 
diff --git a/developer-tools/dashboard/index.md b/developer-tools/dashboard/index.md
index 6f02484793e..1f49212a3a8 100644
--- a/developer-tools/dashboard/index.md
+++ b/developer-tools/dashboard/index.md
@@ -24,17 +24,17 @@ Select one of the cards below to learn more about using the dashboard.
 <CardList
   items={[
     {
-      href: "./get-started/create-api",
+      href: "/developer-tools/dashboard/get-started/create-api",
       title: "Create an API key",
       description: "Learn how to create an API key that allows you to make API calls."
     },
     {
-      href: "./how-to/secure-an-api/api-key",
+      href: "/developer-tools/dashboard/how-to/secure-an-api/api-key",
       title: "Secure your API key",
       description: "Learn how to secure your API key to avoid unwanted costs and unauthorized access."
     },
     {
-      href: "./how-to/dashboard-stats",
+      href: "/developer-tools/dashboard/how-to/dashboard-stats",
       title: "Monitor API call stats",
       description: "Learn how to use the dashboard to view API call stats."
     }
diff --git a/gator_versioned_docs/version-0.1.0/index.mdx b/gator_versioned_docs/version-0.1.0/index.mdx
index 12c7da4e59a..7acaf988081 100644
--- a/gator_versioned_docs/version-0.1.0/index.mdx
+++ b/gator_versioned_docs/version-0.1.0/index.mdx
@@ -22,12 +22,12 @@ Delegation is powered by the [Delegation Framework](https://github.com/metamask/
 
 <CardList items={[
   {
-    href: "get-started/smart-account-quickstart",
+    href: "/smart-accounts-kit/get-started/smart-account-quickstart",
     title: "Smart account quickstart",
     description: "Create a MetaMask smart account and send a user operation.",
   },
   {
-    href: "guides/delegation/execute-on-smart-accounts-behalf",
+    href: "/smart-accounts-kit/guides/delegation/execute-on-smart-accounts-behalf",
     title: "Delegation guide",
     description: "Execute on the behalf of MetaMask Smart Accounts.",
   }
@@ -40,7 +40,7 @@ Advanced Permissions allow you to perform executions on the behalf of MetaMask u
 
 <CardList items={[
   {
-    href: "guides/advanced-permissions/execute-on-metamask-users-behalf",
+    href: "/smart-accounts-kit/guides/advanced-permissions/execute-on-metamask-users-behalf",
     title: "Advanced Permissions (ERC-7715) guide",
     description: "Execute on the behalf of MetaMask users.",
   }
@@ -54,12 +54,12 @@ Check out the following documentation from these partners:
 <CardList
   items={[
     {
-      href: "get-started/use-scaffold-eth/smart-accounts",
+      href: "/smart-accounts-kit/get-started/use-scaffold-eth/smart-accounts",
       title: "Smart Accounts with Scaffold-ETH 2",
       description: "Install the MetaMask Smart Accounts extension for Scaffold-ETH 2.",
     },
     {
-      href: "get-started/use-scaffold-eth/advanced-permissions",
+      href: "/smart-accounts-kit/get-started/use-scaffold-eth/advanced-permissions",
       title: "Advanced Permissions with Scaffold-ETH 2",
       description: "Install the MetaMask Advanced Permissions (ERC-7715) extension for Scaffold-ETH 2.",
     },
diff --git a/gator_versioned_docs/version-0.13.0/index.md b/gator_versioned_docs/version-0.13.0/index.md
index 91e49731929..8d8d1e2d22a 100644
--- a/gator_versioned_docs/version-0.13.0/index.md
+++ b/gator_versioned_docs/version-0.13.0/index.md
@@ -43,22 +43,22 @@ Check out the following guides to get started with the MetaMask Delegation Toolk
 <CardList
 items={[
 {
-href: "get-started/install",
+href: "/smart-accounts-kit/0.13.0/get-started/install",
 title: "Install and set up",
 description: "Install and set up the MetaMask Delegation Toolkit.",
 },
 {
-href: "get-started/smart-account-quickstart",
+href: "/smart-accounts-kit/0.13.0/get-started/smart-account-quickstart",
 title: "MetaMask Smart Accounts quickstart",
 description: "Create a MetaMask smart account and send a user operation.",
 },
 {
-href: "get-started/smart-account-quickstart/eip7702",
+href: "/smart-accounts-kit/0.13.0/get-started/smart-account-quickstart/eip7702",
 title: "EIP-7702 quickstart",
 description: "Upgrade an externally owned account to a smart account.",
 },
 {
-href: "get-started/use-the-cli",
+href: "/smart-accounts-kit/0.13.0/get-started/use-the-cli",
 title: "Use the CLI",
 description: "Use the Delegation Toolkit CLI to bootstrap a project.",
 }
diff --git a/services/reference/arbitrum/index.md b/services/reference/arbitrum/index.md
index 36aa6b2b349..a07e0f56cb2 100644
--- a/services/reference/arbitrum/index.md
+++ b/services/reference/arbitrum/index.md
@@ -33,12 +33,12 @@ Select one of the following options to get started with the Arbitrum network:
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/arbitrum/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect to Arbitrum and make calls to the network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/arbitrum/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the Arbitrum network."
     },
diff --git a/services/reference/avalanche-c-chain/index.md b/services/reference/avalanche-c-chain/index.md
index f864e3b1807..ff7f4c13bef 100644
--- a/services/reference/avalanche-c-chain/index.md
+++ b/services/reference/avalanche-c-chain/index.md
@@ -39,12 +39,12 @@ Select one of the following options to get started with the Avalanche C-Chain ne
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/avalanche-c-chain/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect to Avalanche C-Chain and make calls to the network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/avalanche-c-chain/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the Avalanche C-Chain network."
     },
diff --git a/services/reference/base/index.md b/services/reference/base/index.md
index 68921fc387f..e673b4cf292 100644
--- a/services/reference/base/index.md
+++ b/services/reference/base/index.md
@@ -25,12 +25,12 @@ Select an option below to get started with the Base network.
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/base/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the Base network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/base/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the Base network."
     },
diff --git a/services/reference/blast/index.md b/services/reference/blast/index.md
index 8be7603a3a8..7d76ba07703 100644
--- a/services/reference/blast/index.md
+++ b/services/reference/blast/index.md
@@ -32,12 +32,12 @@ Select one of the following options to get started with the Blast network:
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/blast/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the Blast network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/blast/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the Blast network."
     },
diff --git a/services/reference/bnb-smart-chain/index.md b/services/reference/bnb-smart-chain/index.md
index 93aa5ff85c2..b3b3a71a707 100644
--- a/services/reference/bnb-smart-chain/index.md
+++ b/services/reference/bnb-smart-chain/index.md
@@ -36,12 +36,12 @@ Select an option below to get started with the BSC network.
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/bnb-smart-chain/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the BNB Smart Chain network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/bnb-smart-chain/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the BNB Smart Chain network."
     },
diff --git a/services/reference/celo/index.md b/services/reference/celo/index.md
index 031a9421445..d0a0aaaebe5 100644
--- a/services/reference/celo/index.md
+++ b/services/reference/celo/index.md
@@ -19,12 +19,12 @@ Select an option below to get started with the Celo network.
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/celo/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the Celo network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/celo/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the Celo network."
     },
diff --git a/services/reference/ethereum/index.md b/services/reference/ethereum/index.md
index a4db7badebe..848b0807b16 100644
--- a/services/reference/ethereum/index.md
+++ b/services/reference/ethereum/index.md
@@ -24,12 +24,12 @@ The [official Ethereum documentation](https://ethereum.org/en/) for more informa
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/ethereum/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the Ethereum network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/ethereum/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the Ethereum network."
     },
diff --git a/services/reference/gas-api/index.md b/services/reference/gas-api/index.md
index 229e361a149..83694bc5f20 100644
--- a/services/reference/gas-api/index.md
+++ b/services/reference/gas-api/index.md
@@ -15,12 +15,12 @@ See the [list of supported Gas API networks](../../get-started/endpoints.md#gas-
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/gas-api/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the Gas API."
     },
     {
-      href: "./api-reference",
+      href: "/services/reference/gas-api/api-reference",
       title: "REST APIs",
       description: "View the APIs available for communicating with the Gas API."
     },
diff --git a/services/reference/hemi/index.md b/services/reference/hemi/index.md
index eeed52d2804..4251da7b862 100644
--- a/services/reference/hemi/index.md
+++ b/services/reference/hemi/index.md
@@ -30,12 +30,12 @@ Select an option below to get started with the Hemi network.
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/hemi/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the Hemi network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/hemi/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the Hemi network."
     },
diff --git a/services/reference/ipfs/index.md b/services/reference/ipfs/index.md
index 4c1519d9656..2a093d962de 100644
--- a/services/reference/ipfs/index.md
+++ b/services/reference/ipfs/index.md
@@ -28,12 +28,12 @@ See the [official IPFS documentation](https://docs.ipfs.io) for more information
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/ipfs/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the IPFS network."
     },
     {
-      href: "./http-api-methods",
+      href: "/services/reference/ipfs/http-api-methods",
       title: "HTTP APIs",
       description: "View the APIs available for communicating with the IPFS network."
     },
diff --git a/services/reference/linea/index.md b/services/reference/linea/index.md
index 94a5e9b5e1f..9e79b3a5a71 100644
--- a/services/reference/linea/index.md
+++ b/services/reference/linea/index.md
@@ -20,12 +20,12 @@ See the [official Linea documentation](https://docs.linea.build/) for more infor
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/linea/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the Linea network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/linea/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the Linea network."
     },
diff --git a/services/reference/mantle/index.md b/services/reference/mantle/index.md
index 3626894c454..7d929c50884 100644
--- a/services/reference/mantle/index.md
+++ b/services/reference/mantle/index.md
@@ -34,12 +34,12 @@ Select one of the following options to get started with the Mantle network:
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/mantle/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the Mantle network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/mantle/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the Mantle network."
     },
diff --git a/services/reference/opbnb/index.md b/services/reference/opbnb/index.md
index f025347febd..8c5074183ae 100644
--- a/services/reference/opbnb/index.md
+++ b/services/reference/opbnb/index.md
@@ -34,12 +34,12 @@ Select an option below to get started with the opBNB network.
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/opbnb/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the opBNB network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/opbnb/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the opBNB network."
     },
diff --git a/services/reference/optimism/index.md b/services/reference/optimism/index.md
index 73c92d49f62..490b8b2f354 100644
--- a/services/reference/optimism/index.md
+++ b/services/reference/optimism/index.md
@@ -29,12 +29,12 @@ occur on Optimism are posted and validated on Ethereum mainnet using Optimistic
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/optimism/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the Optimism network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/optimism/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the Optimism network."
     },
diff --git a/services/reference/palm/index.md b/services/reference/palm/index.md
index bb151edb5ae..60ef6ff6b15 100644
--- a/services/reference/palm/index.md
+++ b/services/reference/palm/index.md
@@ -20,12 +20,12 @@ The [official Palm documentation](https://docs.palm.io/) for more information ab
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/palm/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the Palm network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/palm/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the Palm network."
     },
diff --git a/services/reference/polygon-pos/index.md b/services/reference/polygon-pos/index.md
index eaf8e140bf6..3fb243e4c47 100644
--- a/services/reference/polygon-pos/index.md
+++ b/services/reference/polygon-pos/index.md
@@ -29,12 +29,12 @@ The [official Polygon documentation](https://docs.polygon.technology) for more i
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/polygon-pos/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the Polygon network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/polygon-pos/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the Polygon network."
     },
diff --git a/services/reference/scroll/index.md b/services/reference/scroll/index.md
index 8c157a81878..57561920820 100644
--- a/services/reference/scroll/index.md
+++ b/services/reference/scroll/index.md
@@ -32,12 +32,12 @@ See the [official Scroll documentation](https://docs.scroll.io/en/home/) for mor
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/scroll/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the Scroll network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/scroll/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the Scroll network."
     },
diff --git a/services/reference/sei/index.md b/services/reference/sei/index.md
index 9ef28974389..cc91b79c3a0 100644
--- a/services/reference/sei/index.md
+++ b/services/reference/sei/index.md
@@ -26,12 +26,12 @@ Select an option below to get started with the Sei network.
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/sei/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the Sei network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/sei/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the Sei network."
     },
diff --git a/services/reference/solana/index.md b/services/reference/solana/index.md
index 73b8baffaea..c700b3de0ba 100644
--- a/services/reference/solana/index.md
+++ b/services/reference/solana/index.md
@@ -27,12 +27,12 @@ Select an option below to get started with the Solana network.
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/solana/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the Solana network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/solana/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the Solana network."
     },
diff --git a/services/reference/starknet/index.md b/services/reference/starknet/index.md
index 377d0708e6e..6079e6d46e2 100644
--- a/services/reference/starknet/index.md
+++ b/services/reference/starknet/index.md
@@ -27,12 +27,12 @@ See the [Starknet documentation](https://docs.starknet.io/documentation/) to fin
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/starknet/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the Starknet network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/starknet/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the Starknet network."
     },
diff --git a/services/reference/swellchain/index.md b/services/reference/swellchain/index.md
index 5c18fd7ee27..f9d0c6904d1 100644
--- a/services/reference/swellchain/index.md
+++ b/services/reference/swellchain/index.md
@@ -31,12 +31,12 @@ Select an option below to get started with the Swellchain network.
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/swellchain/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to Swellchain."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/swellchain/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with Swellchain."
     },
diff --git a/services/reference/unichain/index.md b/services/reference/unichain/index.md
index 6e502ecde3d..ccc6edbd4dc 100644
--- a/services/reference/unichain/index.md
+++ b/services/reference/unichain/index.md
@@ -35,12 +35,12 @@ See the [official Unichain documentation](https://docs.unichain.org/docs) for mo
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/unichain/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the Unichain network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/unichain/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the Unichain network."
     },
diff --git a/services/reference/zksync/index.md b/services/reference/zksync/index.md
index ecd8e0bef93..ca60e435c04 100644
--- a/services/reference/zksync/index.md
+++ b/services/reference/zksync/index.md
@@ -28,12 +28,12 @@ See the [official ZKsync Era documentation](https://docs.zksync.io) for more inf
 <CardList
   items={[
     {
-      href: "./quickstart",
+      href: "/services/reference/zksync/quickstart",
       title: "Quickstart",
       description: "Learn how to quickly connect and make calls to the ZKsync Era network."
     },
     {
-      href: "./json-rpc-methods",
+      href: "/services/reference/zksync/json-rpc-methods",
       title: "JSON-RPC APIs",
       description: "View the APIs available for communicating with the ZKsync Era network."
     },
diff --git a/smart-accounts-kit/index.mdx b/smart-accounts-kit/index.mdx
index 12c7da4e59a..3be693420e5 100644
--- a/smart-accounts-kit/index.mdx
+++ b/smart-accounts-kit/index.mdx
@@ -22,12 +22,12 @@ Delegation is powered by the [Delegation Framework](https://github.com/metamask/
 
 <CardList items={[
   {
-    href: "get-started/smart-account-quickstart",
+    href: "/smart-accounts-kit/development/get-started/smart-account-quickstart",
     title: "Smart account quickstart",
     description: "Create a MetaMask smart account and send a user operation.",
   },
   {
-    href: "guides/delegation/execute-on-smart-accounts-behalf",
+    href: "/smart-accounts-kit/development/guides/delegation/execute-on-smart-accounts-behalf",
     title: "Delegation guide",
     description: "Execute on the behalf of MetaMask Smart Accounts.",
   }
@@ -40,7 +40,7 @@ Advanced Permissions allow you to perform executions on the behalf of MetaMask u
 
 <CardList items={[
   {
-    href: "guides/advanced-permissions/execute-on-metamask-users-behalf",
+    href: "/smart-accounts-kit/development/guides/advanced-permissions/execute-on-metamask-users-behalf",
     title: "Advanced Permissions (ERC-7715) guide",
     description: "Execute on the behalf of MetaMask users.",
   }
@@ -54,12 +54,12 @@ Check out the following documentation from these partners:
 <CardList
   items={[
     {
-      href: "get-started/use-scaffold-eth/smart-accounts",
+      href: "/smart-accounts-kit/development/get-started/use-scaffold-eth/smart-accounts",
       title: "Smart Accounts with Scaffold-ETH 2",
       description: "Install the MetaMask Smart Accounts extension for Scaffold-ETH 2.",
     },
     {
-      href: "get-started/use-scaffold-eth/advanced-permissions",
+      href: "/smart-accounts-kit/development/get-started/use-scaffold-eth/advanced-permissions",
       title: "Advanced Permissions with Scaffold-ETH 2",
       description: "Install the MetaMask Advanced Permissions (ERC-7715) extension for Scaffold-ETH 2.",
     },

From 4e81fcebcacc8271a9b22711f64fbdabc1b3cfb8 Mon Sep 17 00:00:00 2001
From: Alexandra Carrillo <alexandra.carrillo@consensys.net>
Date: Tue, 18 Nov 2025 19:05:35 -0800
Subject: [PATCH 2/3] edit contribution guide

---
 CONTRIBUTING.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index b469a856f64..07b339e0cef 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -10,6 +10,7 @@ guide in some places.
 - [Contribution workflow](#contribution-workflow)
 - [Preview locally](#preview-locally)
 - [Style guide](#style-guide)
+- [Format links](#format-links)
 - [Add images](#add-images)
 - [Update the interactive API reference](#update-the-interactive-api-reference)
   - [Update `MetaMask/api-specs`](#update-metamaskapi-specs)
@@ -120,17 +121,18 @@ Refer to the [Consensys documentation style guide](https://docs-template.consens
 
 Most links in the Markdown pages use *relative file paths*, for example:
 
-```md title="Relative file path in Smart Accounts Kit docs"
+```md
 You can enable users to create a [MetaMask smart account](../../concepts/smart-accounts.md) directly in your dapp.
 ```
 
 However, when linking between different product sections or using the `CardList` component, use *absolute URL paths*. For example:
 
-```md title="Absolute URL path in Wallet API docs"
-When a dapp requests to submit a batch of transactions atomically, MetaMask may prompt users to upgrade their externally owned account (EOA) to a [MetaMask smart account](/smart-accounts-kit/concepts/smart-accounts).
+```md
+When a dapp requests to submit a batch of transactions atomically, MetaMask may prompt users to upgrade their
+externally owned account (EOA) to a [MetaMask smart account](/smart-accounts-kit/concepts/smart-accounts).
 ```
 
-```md title="Absolute URL path in Snaps docs"
+```md
 <CardList
   items={[
     {

From 5973391d96d1f6a748594246787df2b158426e2d Mon Sep 17 00:00:00 2001
From: Alexandra Carrillo <alexandra.carrillo@consensys.net>
Date: Tue, 18 Nov 2025 19:32:02 -0800
Subject: [PATCH 3/3] fix linkspector errors

---
 .linkspector.yml                           | 2 ++
 services/reference/mantle/index.md         | 2 +-
 services/reference/unichain/index.md       | 4 +---
 wallet/concepts/wallet-interoperability.md | 2 +-
 wallet/how-to/connect-extension.md         | 2 +-
 5 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/.linkspector.yml b/.linkspector.yml
index 24b55b1bf36..0c12466ee51 100644
--- a/.linkspector.yml
+++ b/.linkspector.yml
@@ -32,6 +32,8 @@ ignorePatterns:
 - pattern: '^/snaps/'
 - pattern: '^/wallet/'
 - pattern: '^/tutorials/'
+- pattern: 'https://web3onboard.thirdweb.com'
+- pattern: 'https://0xfury.com/privacy'
 aliveStatusCodes:
 - 200
 - 206
diff --git a/services/reference/mantle/index.md b/services/reference/mantle/index.md
index 7d929c50884..44ad1b42966 100644
--- a/services/reference/mantle/index.md
+++ b/services/reference/mantle/index.md
@@ -57,5 +57,5 @@ No personal information is sent as part of partner requests, only information ne
 
 The following partner provides access to the Mantle network:
 
-- 0xFury ([Privacy policy](https://0xfury.com/privacy.php))
+- 0xFury ([Privacy policy](https://0xfury.com/privacy))
 - Bware Labs ([Terms of Use](https://bwarelabs.com/terms), [Privacy Policy](https://bwarelabs.com/privacy))
diff --git a/services/reference/unichain/index.md b/services/reference/unichain/index.md
index ccc6edbd4dc..4aef7c9a8af 100644
--- a/services/reference/unichain/index.md
+++ b/services/reference/unichain/index.md
@@ -58,7 +58,5 @@ No personal information is sent as part of partner requests, only information ne
 
 The following partners provide access to the Unichain network:
 
-<!-- markdown-link-check-disable -->
 - InfStones ([Privacy Policy](https://infstones.com/terms/privacy-notice))
-- 0xFury ([Privacy policy](https://0xfury.com/privacy.php))
-<!-- markdown-link-check-enable -->
+- 0xFury ([Privacy policy](https://0xfury.com/privacy))
diff --git a/wallet/concepts/wallet-interoperability.md b/wallet/concepts/wallet-interoperability.md
index 9497bc6f03b..4bdbdefa1f4 100644
--- a/wallet/concepts/wallet-interoperability.md
+++ b/wallet/concepts/wallet-interoperability.md
@@ -84,7 +84,7 @@ The following third-party libraries support EIP-6963:
 - [MIPD Store](https://github.com/wevm/mipd)
 - [RainbowKit](https://www.rainbowkit.com)
 - [Web3-Onboard](https://web3onboard.thirdweb.com)
-- [ConnectKit](https://docs.family.co/connectkit)
+- [ConnectKit](https://family.co/docs/connectkit)
 
 ### MIPD Store
 
diff --git a/wallet/how-to/connect-extension.md b/wallet/how-to/connect-extension.md
index 9e4b29f08c9..e1a36f36ea8 100644
--- a/wallet/how-to/connect-extension.md
+++ b/wallet/how-to/connect-extension.md
@@ -34,7 +34,7 @@ You can connect to MetaMask using the following third-party libraries that suppo
 - [MIPD Store](https://github.com/wevm/mipd)
 - [RainbowKit](https://rainbowkit.com/docs/introduction)
 - [Web3-Onboard](https://web3onboard.thirdweb.com)
-- [ConnectKit](https://docs.family.co/connectkit)
+- [ConnectKit](https://family.co/docs/connectkit)
 
 ## Connect to MetaMask directly using Vite