From 70f3155d13943835a94731ab5ea6cb3a922c7ecb Mon Sep 17 00:00:00 2001
From: Aimen Sahnoun <aimensahnoun@outlook.com>
Date: Thu, 26 Feb 2026 17:10:46 +0400
Subject: [PATCH] docs(nav): align visible use cases and fix homepage card
 links Updated the Use Cases navigation and entry-point cards to reflect only
 currently supported/visible content in Mintlify. Removed hidden AI-only
 use-case pages (payouts, payroll, subscriptions) from docs.json, updated
 Payment Processing Demo to highlight payment-detection, invoicing, and
 checkout, and fixed broken welcome-page card links (API Features and SDK
 (Legacy)). Also removed the Release Notes tab from navigation and dropped the
 release-notes card from the welcome page to match current migration scope.

---
 docs.json                             | 18 +-----------------
 use-cases/payment-processing-demo.mdx | 24 ++++++++++++------------
 use-cases/welcome.mdx                 | 16 ++++------------
 3 files changed, 17 insertions(+), 41 deletions(-)

diff --git a/docs.json b/docs.json
index 3e497ac..b8caa16 100644
--- a/docs.json
+++ b/docs.json
@@ -51,10 +51,7 @@
             "pages": [
               "use-cases/payment-detection",
               "use-cases/invoicing",
-              "use-cases/payouts",
-              "use-cases/payroll",
-              "use-cases/checkout",
-              "use-cases/subscriptions"
+              "use-cases/checkout"
             ]
           }
         ]
@@ -179,19 +176,6 @@
             ]
           }
         ]
-      },
-      {
-        "tab": "Release Notes",
-        "groups": [
-          {
-            "group": "📋 Release Notes",
-            "pages": [
-              "release-notes/index",
-              "release-notes/request-api",
-              "release-notes/easy-invoice"
-            ]
-          }
-        ]
       }
     ]
   },
diff --git a/use-cases/payment-processing-demo.mdx b/use-cases/payment-processing-demo.mdx
index 40607d2..4da2481 100644
--- a/use-cases/payment-processing-demo.mdx
+++ b/use-cases/payment-processing-demo.mdx
@@ -41,6 +41,14 @@ import { DemoContainer } from '/snippets/demo-container.jsx'
   
   <div style={{ marginBottom: '0.5rem' }}>
     <CardGroup cols={3}>
+      <Card 
+        title="🔍 Payment Detection" 
+        href="/use-cases/payment-detection"
+        icon="magnifying-glass-dollar"
+      >
+        Track incoming payments automatically and reconcile transactions in real time
+      </Card>
+
       <Card 
         title="📄 Invoicing" 
         href="/use-cases/invoicing"
@@ -50,19 +58,11 @@ import { DemoContainer } from '/snippets/demo-container.jsx'
       </Card>
       
       <Card 
-        title="💸 Payouts" 
-        href="/use-cases/payouts"
-        icon="money-bill-transfer"
-      >
-        Send batch payments to multiple recipients with automatic tracking
-      </Card>
-
-      <Card 
-        title="💰 Payroll" 
-        href="/use-cases/payroll"
-        icon="users"
+        title="🛒 Checkout" 
+        href="/use-cases/checkout"
+        icon="cart-shopping"
       >
-        Pay your team in crypto with automated payroll runs
+        Accept crypto payments in your checkout flow with built-in request tracking
       </Card>
     </CardGroup>
   </div>
diff --git a/use-cases/welcome.mdx b/use-cases/welcome.mdx
index 79bef86..4294aa9 100644
--- a/use-cases/welcome.mdx
+++ b/use-cases/welcome.mdx
@@ -64,12 +64,12 @@ import { DemoContainer } from '/snippets/demo-container.jsx'
         href="/use-cases/payment-detection"
         icon="briefcase"
       >
-        Explore specific business scenarios: payment detection, invoicing, payouts, payroll, checkout, and subscriptions
+        Explore specific business scenarios: payment detection, invoicing, and checkout
       </Card>
       
       <Card 
         title="API Features" 
-        href="/api-features/payment-types"
+        href="/api-features/payment-types-overview"
         icon="code"
       >
         The easiest way to integrate. Payment types, webhooks, and developer tools.
@@ -78,7 +78,7 @@ import { DemoContainer } from '/snippets/demo-container.jsx'
   </div>
 
   <div style={{ marginBottom: '3rem' }}>
-    <CardGroup cols={3}>
+    <CardGroup cols={2}>
       <Card 
         title="🌐 Resources" 
         href="/resources/supported-chains-and-currencies"
@@ -88,19 +88,11 @@ import { DemoContainer } from '/snippets/demo-container.jsx'
       </Card>
       <Card 
         title="SDK (Legacy)" 
-        href="/sdk-legacy/migration-guide"
+        href="/sdk-legacy/overview"
         icon="clock"
       >
         Legacy SDK and protocol documentation for advanced users
       </Card>
-      
-      <Card 
-        title="📋 Release Notes" 
-        href="/release-notes/index"
-        icon="newspaper"
-      >
-        Stay updated with the latest features and improvements
-      </Card>
     </CardGroup>
   </div>
 </div>