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"
 />
 
----
+Learn how to create a payment provider in [this guide](/references/payment/provider).
-
-## 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"
-    }
-  ]}
-/>

www/apps/resources/generated/edit-dates.mjs

@@ -119,7 +119,7 @@ export const generatedEditDates = {
   "app/deployment/medusa-application/railway/page.mdx": "2024-11-11T11:50:10.517Z",
   "app/deployment/storefront/vercel/page.mdx": "2024-07-26T07:21:31+00:00",
   "app/deployment/page.mdx": "2024-11-25T14:31:45.277Z",
-  "app/integrations/page.mdx": "2024-11-19T10:09:54.075Z",
+  "app/integrations/page.mdx": "2024-12-10T08:20:41.203Z",
   "app/medusa-cli/page.mdx": "2024-08-28T11:25:32.382Z",
   "app/medusa-container-resources/page.mdx": "2024-12-09T16:18:38.852Z",
   "app/medusa-workflows-reference/page.mdx": "2024-12-09T16:22:32.129Z",

www/apps/resources/generated/sidebar.mjs

@@ -7983,6 +7983,46 @@ export const generatedSidebar = [
     "title": "Integrations",
     "isChildSidebar": true,
     "children": [
+      {
+        "loaded": true,
+        "isPathHref": true,
+        "type": "category",
+        "title": "Auth",
+        "children": [
+          {
+            "loaded": true,
+            "isPathHref": true,
+            "type": "link",
+            "path": "/commerce-modules/auth/auth-providers/google",
+            "title": "Google",
+            "children": []
+          },
+          {
+            "loaded": true,
+            "isPathHref": true,
+            "type": "link",
+            "path": "/commerce-modules/auth/auth-providers/github",
+            "title": "GitHub",
+            "children": []
+          }
+        ]
+      },
+      {
+        "loaded": true,
+        "isPathHref": true,
+        "type": "category",
+        "title": "CMS",
+        "children": [
+          {
+            "loaded": true,
+            "isPathHref": true,
+            "type": "link",
+            "path": "/integrations/guides/sanity",
+            "title": "Sanity",
+            "children": []
+          }
+        ]
+      },
       {
         "loaded": true,
         "isPathHref": true,
@@ -8012,6 +8052,14 @@ export const generatedSidebar = [
             "path": "/architectural-modules/notification/sendgrid",
             "title": "SendGrid",
             "children": []
+          },
+          {
+            "loaded": true,
+            "isPathHref": true,
+            "type": "link",
+            "path": "/integrations/guides/resend",
+            "title": "Resend",
+            "children": []
           }
         ]
       },
@@ -8030,30 +8078,6 @@ export const generatedSidebar = [
             "children": []
           }
         ]
-      },
-      {
-        "loaded": true,
-        "isPathHref": true,
-        "type": "category",
-        "title": "Guides",
-        "children": [
-          {
-            "loaded": true,
-            "isPathHref": true,
-            "type": "link",
-            "path": "/integrations/guides/sanity",
-            "title": "Sanity",
-            "children": []
-          },
-          {
-            "loaded": true,
-            "isPathHref": true,
-            "type": "link",
-            "path": "/integrations/guides/resend",
-            "title": "Resend",
-            "children": []
-          }
-        ]
       }
     ]
   },

www/apps/resources/sidebar.mjs

@@ -1744,6 +1744,33 @@ export const sidebar = sidebarAttachHrefCommonOptions([
     title: "Integrations",
     isChildSidebar: true,
     children: [
+      {
+        type: "category",
+        title: "Auth",
+        children: [
+          {
+            type: "link",
+            path: "/commerce-modules/auth/auth-providers/google",
+            title: "Google",
+          },
+          {
+            type: "link",
+            path: "/commerce-modules/auth/auth-providers/github",
+            title: "GitHub",
+          },
+        ],
+      },
+      {
+        type: "category",
+        title: "CMS",
+        children: [
+          {
+            type: "link",
+            path: "/integrations/guides/sanity",
+            title: "Sanity",
+          },
+        ],
+      },
       {
         type: "category",
         title: "File",
@@ -1764,6 +1791,11 @@ export const sidebar = sidebarAttachHrefCommonOptions([
             path: "/architectural-modules/notification/sendgrid",
             title: "SendGrid",
           },
+          {
+            type: "link",
+            path: "/integrations/guides/resend",
+            title: "Resend",
+          },
         ],
       },
       {
@@ -1777,22 +1809,6 @@ export const sidebar = sidebarAttachHrefCommonOptions([
           },
         ],
       },
-      {
-        type: "category",
-        title: "Guides",
-        children: [
-          {
-            type: "link",
-            path: "/integrations/guides/sanity",
-            title: "Sanity",
-          },
-          {
-            type: "link",
-            path: "/integrations/guides/resend",
-            title: "Resend",
-          },
-        ],
-      },
     ],
   },
   {