docs: revise integrations page (#10518)

www/apps/resources/app/integrations/page.mdx

@@ -6,11 +6,55 @@ export const metadata = {
 
 # {metadata.title}
 
-Find in this document Medusa's modules that integrate third-party services and systems.
+You can integrate any third-party service to Medusa, including storage services, notification systems, Content-Management Systems (CMS), etc… By integrating third-party services, you build flows and synchronize data around these integrations, making Medusa not only your commerce application, but a middleware layer between your data sources and operations.
+
+Medusa provides integrations out-of-the-box that are listed here, but you can also create your own integrations, such as integrating ERP systems, as explained in [this guide](!docs!/learn/customization/integrate-systems).
+
+## Auth
+
+An Auth Module Provider authenticates users with their account on a third-party service.
+
+<CardList
+  items={[
+    {
+      href: "/commerce-modules/auth/auth-providers/google",
+      title: "Google",
+    },
+    {
+      href: "/commerce-modules/auth/auth-providers/github",
+      title: "GitHub",
+    },
+  ]}
+  className="mb-1"
+/>
+
+Learn how to create a custom third-party authentication provider in [this guide](/references/auth/provider).
+
+---
+
+## CMS
+
+Integrate third-party CMS to utilize rich content-related features.
+
+<CardList
+  items={[
+    {
+      href: "/integrations/guides/sanity",
+      title: "Sanity",
+      badge: {
+        variant: "blue",
+        children: "Guide"
+      }
+    },
+  ]}
+  className="mb-1"
+/>
+
+---
 
 ## File
 
-Learn how to create a file provider in [this guide](/references/file-provider-module).
+A File Module Provider uploads and manages assets, such as product images, on a third-party service.
 
 <CardList
   items={[
@@ -19,28 +63,42 @@ Learn how to create a file provider in [this guide](/references/file-provider-mo
       title: "AWS S3 (and Compatible APIs)"
     }
   ]}
+  className="mb-1"
 />
 
+Learn how to create a custom third-party file or storage provider in [this guide](/references/file-provider-module).
+
 ---
 
 ## Notification
 
-Learn how to create a notification provider in [this guide](/references/notification-provider-module).
+A Notification Module Provider sends messages to users and customers in your Medusa application using a third-party service.
 
 <CardList
   items={[
     {
       href: "/architectural-modules/notification/sendgrid",
       title: "SendGrid"
+    },
+    {
+      href: "/integrations/guides/resend",
+      title: "Resend",
+      badge: {
+        variant: "blue",
+        children: "Guide"
+      }
     }
   ]}
+  className="mb-1"
 />
 
+Learn how to create a notification provider in [this guide](/references/notification-provider-module).
+
 ---
 
 ## Payment
 
-Learn how to create a payment provider in [this guide](/references/payment/provider).
+A Payment Module Provider processes payments made in your Medusa store using a third-party service.
 
 <CardList
   items={[
@@ -49,23 +107,7 @@ Learn how to create a payment provider in [this guide](/references/payment/provi
       title: "Stripe"
     }
   ]}
+  className="mb-1"
 />
 
----
-
-## Guides
-
-The following guides are step-by-step guides on how to integrate Medusa to third-party systems.
-
-<CardList
-  items={[
-    {
-      href: "/integrations/guides/sanity",
-      title: "Sanity"
-    },
-    {
-      href: "/integrations/guides/resend",
-      title: "Resend"
-    }
-  ]}
-/>
+Learn how to create a payment provider in [this guide](/references/payment/provider).