docs: general fixes and improvements (#7918)

* docs improvements and changes

* updated module definition

* modules + dml changes

* fix build

* fix vale error

* fix lint errors

* fixes to stripe docs

* fix condition

* fix condition

* fix module defintion

* fix checkout

* disable UI action

* change oas preview action

* flatten provider module options

* fix lint errors

* add module link docs

* pr comments fixes

* fix vale error

* change node engine version

* links -> linkable

* add note about database name

* small fixes

* link fixes

* fix response code in api reference

* added migrations step

www/apps/resources/app/commerce-modules/tax/examples/page.mdx

@@ -13,10 +13,10 @@ In this guide, you’ll find common examples of how you can use the Tax Module i
 <CodeTabs groupId="app-type">
   <CodeTab label="Medusa API Router" value="medusa">
 
-```ts
-import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
-import { ITaxModuleService } from "@medusajs/types"
-import { ModuleRegistrationName } from "@medusajs/utils"
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { ITaxModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/utils"
 
 export async function GET(
   req: MedusaRequest,
@@ -75,10 +75,10 @@ export async function POST(request: Request) {
 <CodeTabs groupId="app-type">
   <CodeTab label="Medusa API Router" value="medusa">
 
-```ts
-import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
-import { ITaxModuleService } from "@medusajs/types"
-import { ModuleRegistrationName } from "@medusajs/utils"
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { ITaxModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/utils"
 
 export async function GET(
   req: MedusaRequest,
@@ -121,10 +121,10 @@ export async function GET(request: Request) {
 <CodeTabs groupId="app-type">
   <CodeTab label="Medusa API Router" value="medusa">
 
-```ts
-import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
-import { ITaxModuleService } from "@medusajs/types"
-import { ModuleRegistrationName } from "@medusajs/utils"
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { ITaxModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/utils"
 
 export async function POST(
   req: MedusaRequest,
@@ -199,10 +199,10 @@ export async function POST(request: Request) {
 <CodeTabs groupId="app-type">
   <CodeTab label="Medusa API Router" value="medusa">
 
-```ts
-import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
-import { ITaxModuleService } from "@medusajs/types"
-import { ModuleRegistrationName } from "@medusajs/utils"
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { ITaxModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/utils"
 
 export async function GET(
   req: MedusaRequest,
@@ -245,10 +245,10 @@ export async function GET(request: Request) {
 <CodeTabs groupId="app-type">
   <CodeTab label="Medusa API Router" value="medusa">
 
-```ts
-import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
-import { ITaxModuleService } from "@medusajs/types"
-import { ModuleRegistrationName } from "@medusajs/utils"
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { ITaxModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/utils"
 
 export async function GET(
   req: MedusaRequest,

www/apps/resources/app/commerce-modules/tax/module-options/page.mdx

@@ -19,7 +19,7 @@ The `providers` option is an array of either tax module providers, tax plugins,
 When the Medusa application starts, these providers are registered and can be used to retrieve tax lines.
 
 ```js title="medusa-config.js"
-const { Modules } = require("@medusajs/modules-sdk")
+import { Modules } from "@medusajs/utils"
 
 // ...
 
@@ -31,7 +31,8 @@ module.exports = defineConfig({
       options: {
         providers: [
           {
-            resolve: "my-provider",
+            resolve: "./path/to/my-provider",
+            id: "my-provider",
             options: {
               // ...
             },
@@ -46,4 +47,5 @@ module.exports = defineConfig({
 The objects in the array accept the following properties:
 
 - `resolve`: A string indicating the package name of the module provider or the path to it relative to the `src` directory.
-- `options`: An object of options to pass to the module provider.
+- `id`: A string indicating the provider's unique name or ID.
+- `options`: An optional object of the module provider's options.

www/apps/resources/app/commerce-modules/tax/page.mdx

@@ -91,10 +91,10 @@ For example:
 <CodeTabs groupId="resource-type">
   <CodeTab label="API Route" value="api-route">
 
-```ts title="src/api/store/custom/route.ts"
-import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
-import { ITaxModuleService } from "@medusajs/types"
-import { ModuleRegistrationName } from "@medusajs/utils"
+  ```ts title="src/api/store/custom/route.ts"
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { ITaxModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/utils"
 
 export async function GET(
   req: MedusaRequest,
@@ -113,10 +113,10 @@ export async function GET(
   </CodeTab>
   <CodeTab label="Subscriber" value="subscribers">
 
-```ts title="src/subscribers/custom-handler.ts"
-import { SubscriberArgs } from "@medusajs/medusa"
-import { ITaxModuleService } from "@medusajs/types"
-import { ModuleRegistrationName } from "@medusajs/utils"
+  ```ts title="src/subscribers/custom-handler.ts"
+  import { SubscriberArgs } from "@medusajs/medusa"
+  import { ITaxModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/utils"
 
 export default async function subscriberHandler({ container }: SubscriberArgs) {
   const taxModuleService: ITaxModuleService = container.resolve(
@@ -130,10 +130,10 @@ export default async function subscriberHandler({ container }: SubscriberArgs) {
   </CodeTab>
   <CodeTab label="Workflow Step" value="workflow-step">
 
-```ts title="src/workflows/hello-world/step1.ts"
-import { createStep } from "@medusajs/workflows-sdk"
-import { ITaxModuleService } from "@medusajs/types"
-import { ModuleRegistrationName } from "@medusajs/utils"
+  ```ts title="src/workflows/hello-world/step1.ts"
+  import { createStep } from "@medusajs/workflows-sdk"
+  import { ITaxModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/utils"
 
 const step1 = createStep("step-1", async (_, { container }) => {
   const taxModuleService: ITaxModuleService = container.resolve(