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/api-reference/components/MDXComponents/index.tsx

@@ -2,7 +2,7 @@ import type { MDXComponents } from "mdx/types"
 import Security from "./Security"
 import type { OpenAPI } from "types"
 import H2 from "./H2"
-import { Link, MDXComponents as UiMDXComponents } from "docs-ui"
+import { MDXComponents as UiMDXComponents } from "docs-ui"
 
 export type ScopeType = {
   specs?: OpenAPI.OpenAPIV3.Document
@@ -13,7 +13,6 @@ const getCustomComponents = (scope?: ScopeType): MDXComponents => {
   return {
     ...UiMDXComponents,
     Security: () => <Security specs={scope?.specs} />,
-    a: Link,
     h2: (props: React.HTMLAttributes<HTMLHeadingElement>) => <H2 {...props} />,
   }
 }

www/apps/api-reference/components/Tags/Operation/DescriptionSection/Events/index.tsx

@@ -36,7 +36,10 @@ const TagsOperationDescriptionSectionEvents = ({
           <span>
             The following events are emitted by the workflow used in this API
             route. You can listen to and handle these events using a{" "}
-            <Link href="https://docs.medusajs.com/learn/fundamentals/events-and-subscribers">
+            <Link
+              href="https://docs.medusajs.com/learn/fundamentals/events-and-subscribers"
+              variant="content"
+            >
               Subscriber
             </Link>
           </span>

www/apps/api-reference/components/Tags/Operation/DescriptionSection/index.tsx

@@ -117,7 +117,11 @@ const TagsOperationDescriptionSection = ({
       {operation.externalDocs && (
         <>
           Related guide:{" "}
-          <Link href={operation.externalDocs.url} target="_blank">
+          <Link
+            href={operation.externalDocs.url}
+            target="_blank"
+            variant="content"
+          >
             {operation.externalDocs.description || "Read More"}
           </Link>
         </>

www/apps/api-reference/components/Tags/Operation/FeatureFlagNotice/index.tsx

@@ -22,6 +22,7 @@ const TagsOperationFeatureFlagNotice = ({
           <Link
             href="https://docs.medusajs.com/development/feature-flags/toggle"
             target="__blank"
+            variant="content"
           >
             enable its feature flag: <code>{featureFlag}</code>
           </Link>

www/apps/api-reference/components/Tags/Operation/Parameters/Description/index.tsx

@@ -59,7 +59,11 @@ const TagOperationParametersDescription = ({
       {schema.externalDocs && (
         <span>
           Related guide:{" "}
-          <Link href={schema.externalDocs.url} target="_blank">
+          <Link
+            href={schema.externalDocs.url}
+            target="_blank"
+            variant="content"
+          >
             {schema.externalDocs.description || "Read More"}
           </Link>
         </span>

www/apps/api-reference/components/Tags/Section/Schema/index.tsx

@@ -4,7 +4,6 @@ import { Suspense, useEffect, useMemo } from "react"
 import { OpenAPI } from "types"
 import TagOperationParameters from "../../Operation/Parameters"
 import {
-  Badge,
   CodeBlock,
   isElmWindow,
   Link,
@@ -112,7 +111,10 @@ const TagSectionSchema = ({ schema, tagName }: TagSectionSchemaProps) => {
                   Medusa application may support more fields and relations. To
                   view the models in the Medusa application and their relations,
                   visit the{" "}
-                  <Link href="https://docs.medusajs.com/resources/commerce-modules">
+                  <Link
+                    href="https://docs.medusajs.com/resources/commerce-modules"
+                    variant="content"
+                  >
                     Commerce Modules Documentation
                   </Link>
                 </Note>

www/apps/api-reference/components/Tags/Section/index.tsx

@@ -153,7 +153,11 @@ const TagSectionComponent = ({ tag }: TagSectionProps) => {
               {tag.externalDocs && (
                 <p className="mt-1">
                   <span className="text-medium-plus">Related guide:</span>{" "}
-                  <Link href={tag.externalDocs.url} target="_blank">
+                  <Link
+                    href={tag.externalDocs.url}
+                    target="_blank"
+                    variant="content"
+                  >
                     {tag.externalDocs.description || "Read More"}
                   </Link>
                 </p>