Merge branch 'main' into edit-ew-builder-flutter

Author: bgravenorst

.github/PULL_REQUEST_TEMPLATE.md

@@ -18,3 +18,10 @@ Fixes #
 
 - [ ] If this PR updates or adds documentation content that changes or adds technical meaning, it has received an approval from an engineer or DevRel from the relevant team.
 - [ ] If this PR updates or adds documentation content, it has received an approval from a technical writer.
+
+## External contributor checklist
+
+<!-- If you are an external contributor (outside of the MetaMask organization), complete the following checklist. -->
+
+- [ ] I've read the [contribution guidelines](https://github.com/MetaMask/metamask-docs/blob/main/CONTRIBUTING.md).
+- [ ] I've created a new issue (or assigned myself to an existing issue) describing what this PR addresses.

.github/workflows/ci.yml

@@ -61,12 +61,9 @@ jobs:
   linkCheck:
     name: Link Checking
     runs-on: ubuntu-latest
-    strategy:
-      matrix:
-        file-extensions: ['.md', '.mdx']
     steps:
       - uses: actions/checkout@v5
       - name: LinkCheck
         uses: ConsenSys/github-actions/docs-link-check@main
         with:
-          FILE_EXTENSION: ${{ matrix.file-extensions }}
+          CONFIG_FILE: '.linkspector.yml'

.github/workflows/trivy.yml

@@ -1,6 +1,5 @@
 ---
 name: Trivy
-
 on:
   pull_request:
     branches:

.linkspector.yml

@@ -0,0 +1,41 @@
+dirs:
+  - ./smart-accounts-kit
+  - ./developer-tools
+  - ./embedded-wallets
+  - ./sdk
+  - ./services
+  - ./snaps
+  - ./wallet
+excludedDirs:
+  - ./build
+  - ./.vercel
+  - ./.docusaurus
+  - ./node_modules
+useGitIgnore: true
+
+ignorePatterns:
+- pattern: '^http(s)?://localhost'
+- pattern: '^http(s)?://127.0.0.1'
+- pattern: '^http(s)?://gitlab.com/ConsenSys/'
+- pattern: '^http(s)?://consensys.net'
+- pattern: '^http(s)?://.+.zendesk.com'
+- pattern: '^http(s)?://.+.etherscan.io'
+- pattern: '^http(s)?://help.figma.com'
+- pattern: '^http(s)?://metamask.io'
+- pattern: '^http(s)?://rivet.cloud'
+- pattern: '^/img/'
+- pattern: '^/smart-accounts-kit/'
+- pattern: '^/developer-tools/'
+- pattern: '^/embedded-wallets/'
+- pattern: '^/sdk/'
+- pattern: '^/services/'
+- pattern: '^/snaps/'
+- pattern: '^/wallet/'
+- pattern: '^/tutorials/'
+- pattern: 'https://web3onboard.thirdweb.com'
+- pattern: 'https://0xfury.com/privacy'
+aliveStatusCodes:
+- 200
+- 206
+- 400
+- 403

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)
@@ -71,10 +72,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 +117,38 @@ 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
+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
+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
+<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.
 

delegation-toolkit/get-started/supported-networks.md

@@ -28,7 +28,7 @@ Set rate limiting in the API key's **Settings** tab **Key Credit Limits** sectio
     When the number of used credits reaches this limit, all requests will be rejected until the next day (00:00 UTC).
 
 If you exceed the specified limits, you'll receive a JSON response with an
-[HTTP error status code `429`](/services/reference/ethereum/json-rpc-methods#http-errors). For example:
+[HTTP error status code `429`](/services/reference/ethereum/json-rpc-methods/#http-errors). For example:
 
 ```json
 {

delegation-toolkit/guides/delegation/use-delegation-scopes/function-call.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."
     }