docs: docs for next release (#13303)

* added draft order plugin docs

* fix vale error

* added note about draft order being optional

* add new shipping option - shipping method link

* update user guides

* generate

* fix github icon

* changes to shipping option type

* document logger

* reorder list

* fixes

* fixes

www/apps/cloud/app/draft-order-plugin/page.mdx

@@ -1,37 +0,0 @@
-export const metadata = {
-  title: `Draft Order Plugin`,
-}
-
-# {metadata.title}
-
-In this guide, you'll learn about the Draft Order Plugin add-on available to Cloud users.
-
-## What is the Draft Order Plugin?
-
-Draft orders allow admin users to create orders on behalf of customers. They are useful for customer support or when customers place orders offline.
-
-When you sign up for Cloud, you can access the Draft Order plugin in your deployed Medusa applications.
-
-The Draft Order Plugin is an add-on to your Cloud projects that provides draft order features in the Medusa Admin dashboard.
-
----
-
-## Draft Order Plugin Features
-
-The Draft Order Plugin provides the following features:
-
-- Create draft orders from the Medusa Admin dashboard.
-- Manage items in draft orders, including adding, updating, and removing items.
-- Add shipping methods to draft orders.
-- Associate the draft order with a customer in your store.
-- Convert the draft order to a regular order to complete the purchase.
-
-![A screenshot of the draft order management interface in the Medusa Admin dashboard](https://res.cloudinary.com/dza7lstvk/image/upload/v1750235297/Cloud/CleanShot_2025-06-18_at_11.27.36_2x_e6mf4v.png)
-
----
-
-## How to Install the Draft Order Plugin
-
-The Draft Order Plugin is currently only available for Cloud users. If you're not a Cloud user, [learn how to get started](../page.mdx#sign-up-for-cloud).
-
-Then, you can contact support for assistance in installing the Draft Order Plugin in your deployed Medusa application.

www/apps/cloud/app/page.mdx

@@ -25,5 +25,5 @@ Go to [medusajs.com/start](https://medusajs.com/start) and sign up to get starte
 - **Zero Downtime Deployments**: Medusa rolls out changes to production with zero downtime, never interrupting your users.
 - **Autoscaling**: Environments scale to meet traffic demands.
 - **Logging**: Monitor your project's runtime and build logs, so you can easily debug issues in your project.
-- **Early Access**: Access new features before they are open-sourced, for example, Gift Cards and Draft Orders.
+- **Early Access**: Access new features before they are open-sourced, such as Gift Cards.
 - **Dedicated Support**: Receive dedicated support from the Medusa team to help you with any issues you may encounter.

www/apps/cloud/components/MDXComponents/index.tsx

@@ -1,6 +1,5 @@
 import type { MDXComponents as MDXComponentsType } from "mdx/types"
 import {
-  Link,
   MDXComponents as UiMdxComponents,
   InlineThemeImage,
   InlineIcon,
@@ -8,7 +7,6 @@ import {
 
 const MDXComponents: MDXComponentsType = {
   ...UiMdxComponents,
-  a: Link,
   InlineThemeImage,
   InlineIcon,
 }

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

@@ -1,5 +1,5 @@
 export const generatedEditDates = {
-  "app/page.mdx": "2025-06-25T08:00:52.728Z",
+  "app/page.mdx": "2025-08-26T10:31:10.511Z",
   "app/organization/page.mdx": "2025-06-12T14:43:20.772Z",
   "app/projects/page.mdx": "2025-08-25T07:23:12.745Z",
   "app/environments/page.mdx": "2025-06-25T08:00:05.550Z",
@@ -9,7 +9,6 @@ export const generatedEditDates = {
   "app/database/page.mdx": "2025-08-15T15:30:37.814Z",
   "app/redis/page.mdx": "2025-06-25T07:57:23.246Z",
   "app/s3/page.mdx": "2025-06-25T07:57:24.832Z",
-  "app/draft-order-plugin/page.mdx": "2025-06-25T07:57:14.898Z",
   "app/loyalty-plugin/page.mdx": "2025-06-26T11:11:02.320Z",
   "app/logs/page.mdx": "2025-06-19T07:44:38.336Z",
   "app/update-medusa/page.mdx": "2025-06-25T07:57:30.170Z",

www/apps/cloud/generated/sidebar.mjs

@@ -147,7 +147,11 @@ export const generatedSidebars = [
             "isPathHref": true,
             "type": "link",
             "title": "Draft Orders",
-            "path": "/draft-order-plugin",
+            "path": "https://docs.medusajs.com/resources/commerce-modules/order/draft-orders",
+            "badge": {
+              "text": "Published",
+              "variant": "blue"
+            },
             "children": []
           }
         ]

www/apps/cloud/next.config.mjs

@@ -145,6 +145,12 @@ const nextConfig = {
       destination: "/billing",
       permanent: true,
     },
+    {
+      source: "/cloud/draft-order-plugin",
+      destination: "/resources/commerce-modules/order/draft-orders",
+      basePath: false,
+      permanent: true,
+    },
   ],
 }
 

www/apps/cloud/sidebar.mjs

@@ -100,7 +100,11 @@ export const sidebar = [
           {
             type: "link",
             title: "Draft Orders",
-            path: "/draft-order-plugin",
+            path: "https://docs.medusajs.com/resources/commerce-modules/order/draft-orders",
+            badge: {
+              text: "Published",
+              variant: "blue",
+            },
           },
         ],
       },