chore: reorganize docs apps (#7228)

* reorganize docs apps

* add README

* fix directory

* add condition for old docs

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

@@ -0,0 +1,266 @@
+import { CodeTabs, CodeTab } from "docs-ui"
+
+export const metadata = {
+  title: `Examples of the Region Module`,
+}
+
+# {metadata.title}
+
+In this guide, you’ll find common examples of how you can use the Region Module in your application.
+
+## Create a Region
+
+<CodeTabs groupId="app-type">
+  <CodeTab label="Medusa API Router" value="medusa">
+
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { IRegionModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export async function POST(
+    req: MedusaRequest,
+    res: MedusaResponse
+  ): Promise<void> {
+    const regionModuleService: IRegionModuleService =
+      req.scope.resolve(ModuleRegistrationName.REGION)
+
+    const region = await regionModuleService.create({
+      name: "Europe",
+      currency_code: "eur",
+    })
+
+    res.json({
+      region,
+    })
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="Next.js App Router" value="nextjs">
+
+  ```ts
+  import { NextResponse } from "next/server"
+
+  import {
+    initialize as initializeRegionModule,
+  } from "@medusajs/region"
+
+  export async function POST(request: Request) {
+    const regionModuleService = await initializeRegionModule()
+
+    const region = await regionModuleService.create({
+      name: "Europe",
+      currency_code: "eur",
+    })
+
+    res.json({
+      region,
+    })
+  }
+  ```
+
+  </CodeTab>
+</CodeTabs>
+
+---
+
+## List Regions
+
+<CodeTabs groupId="app-type">
+  <CodeTab label="Medusa API Router" value="medusa">
+
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { IRegionModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export async function GET(
+    req: MedusaRequest,
+    res: MedusaResponse
+  ): Promise<void> {
+    const regionModuleService: IRegionModuleService =
+      req.scope.resolve(ModuleRegistrationName.REGION)
+
+    res.json({
+      regions: await regionModuleService.list(),
+    })
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="Next.js App Router" value="nextjs">
+
+  ```ts
+  import { NextResponse } from "next/server"
+
+  import {
+    initialize as initializeRegionModule,
+  } from "@medusajs/region"
+
+  export async function GET(request: Request) {
+    const regionModuleService = await initializeRegionModule()
+
+    return NextResponse.json({
+      regions: await regionModuleService.list(),
+    })
+  }
+  ```
+
+  </CodeTab>
+</CodeTabs>
+
+---
+
+## Retrieve a Region by its ID
+
+<CodeTabs groupId="app-type">
+  <CodeTab label="Medusa API Router" value="medusa">
+
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { IRegionModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export async function GET(
+    req: MedusaRequest,
+    res: MedusaResponse
+  ): Promise<void> {
+    const regionModuleService: IRegionModuleService =
+      req.scope.resolve(ModuleRegistrationName.REGION)
+
+    const region = await regionModuleService.retrieve("reg_123")
+
+    res.json({ region })
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="Next.js App Router" value="nextjs">
+
+  ```ts
+  import { NextResponse } from "next/server"
+
+  import {
+    initialize as initializeRegionModule,
+  } from "@medusajs/region"
+
+  export async function GET(
+    request: Request
+  ) {
+    const regionModuleService = await initializeRegionModule()
+
+    const region = await regionModuleService.retrieve("reg_123")
+
+    return NextResponse.json({ region })
+  }
+  ```
+
+  </CodeTab>
+</CodeTabs>
+
+---
+
+## Update a Region
+
+<CodeTabs groupId="app-type">
+  <CodeTab label="Medusa API Router" value="medusa">
+
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { IRegionModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export async function POST(
+    req: MedusaRequest,
+    res: MedusaResponse
+  ): Promise<void> {
+    const regionModuleService: IRegionModuleService =
+      req.scope.resolve(ModuleRegistrationName.REGION)
+
+    const region = await regionModuleService.update("reg_123", {
+      automatic_taxes: false,
+    })
+
+    res.json({ region })
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="Next.js App Router" value="nextjs">
+
+  ```ts
+  import { NextResponse } from "next/server"
+
+  import {
+    initialize as initializeRegionModule,
+  } from "@medusajs/region"
+
+  export async function POST(
+    request: Request
+  ) {
+    const regionModuleService = await initializeRegionModule()
+
+    const region = await regionModuleService.update("reg_123", {
+      automatic_taxes: false,
+    })
+
+    return NextResponse.json({ region })
+  }
+  ```
+
+  </CodeTab>
+</CodeTabs>
+
+---
+
+## Delete a Region
+
+<CodeTabs groupId="app-type">
+  <CodeTab label="Medusa API Router" value="medusa">
+
+  ```ts
+  import { MedusaRequest, MedusaResponse } from "@medusajs/medusa"
+  import { IRegionModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export async function DELETE(
+    req: MedusaRequest,
+    res: MedusaResponse
+  ): Promise<void> {
+    const regionModuleService: IRegionModuleService =
+      req.scope.resolve(ModuleRegistrationName.REGION)
+
+    await regionModuleService.delete("reg_123")
+
+    res.status(200)
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="Next.js App Router" value="nextjs">
+
+  ```ts
+  import { NextResponse } from "next/server"
+
+  import {
+    initialize as initializeRegionModule,
+  } from "@medusajs/region"
+
+  export async function DELETE(
+    request: Request
+  ) {
+    const regionModuleService = await initializeRegionModule()
+
+    await regionModuleService.delete("reg_123")
+  }
+  ```
+
+  </CodeTab>
+</CodeTabs>
+
+---
+
+## More Examples
+
+The [Region Module interface reference](/references/region) provides a reference to all the methods available for use with examples for each.

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

@@ -0,0 +1,151 @@
+import { CodeTabs, CodeTab } from "docs-ui"
+
+export const metadata = {
+  title: `Region Module`,
+}
+
+# {metadata.title}
+
+The Region Module is the `@medusajs/region` NPM package that provides region-related features in your Medusa and Node.js applications.
+
+---
+
+## What is a Region?
+
+A region represents the area you sell products in. Each region can cover multiple countries, but uses a single currency.
+
+---
+
+## Features
+
+### Region Management
+
+You can manage your regions to create, update, retrieve, or delete them.
+
+```ts
+const region = await regionModuleService.create({
+  name: "Europe",
+  currency_code: "eur",
+})
+```
+
+### Multi-Currency Support
+
+As each region has a currency, you can support multiple currencies in your store by creating multiple regions.
+
+```ts
+const regions = await regionModuleService.create([
+  {
+    name: "Europe",
+    currency_code: "eur",
+  },
+  {
+    name: "United States of America",
+    currency_code: "usd",
+  },
+])
+```
+
+### Different Settings Per Region
+
+Each region has its own settings, such as what countries belong to a region or its tax settings. When using other commerce modules such as the Tax Module or Payment Module, each region has different tax rates, payment providers, and more.
+
+```ts
+const regions = await regionModuleService.create([
+  {
+    name: "Europe",
+    currency_code: "eur",
+    countries: ["dk", "de", "fr", "it", "pt"],
+    automatic_taxes: true,
+  },
+  {
+    name: "United States of America",
+    currency_code: "usd",
+    countries: ["us"],
+    automatic_taxes: false,
+  },
+])
+```
+
+---
+
+## Configure Region Module
+
+After installing the `@medusajs/region` package in your Medusa application, add it to the `modules` object in `medusa-config.js`:
+
+```js title="medusa-config.js"
+const modules = {
+  // ...
+  region: {
+    resolve: "@medusajs/region",
+  },
+}
+```
+
+---
+
+## How to Use Region Module's Service
+
+You can use the Region Module's main service by resolving from the Medusa container the resource `ModuleRegistrationName.REGION` imported from `@medusajs/modules-sdk`.
+
+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 { IRegionModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export async function GET(
+    req: MedusaRequest,
+    res: MedusaResponse
+  ): Promise<void> {
+    const regionModuleService: IRegionModuleService =
+      req.scope.resolve(ModuleRegistrationName.REGION)
+
+    res.json({
+      regions: await regionModuleService.list(),
+    })
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="Subscriber" value="subscribers">
+
+  ```ts title="src/subscribers/custom-handler.ts"
+  import { SubscriberArgs } from "@medusajs/medusa"
+  import { IRegionModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  export default async function subscriberHandler({
+    container,
+  }: SubscriberArgs) {
+    const regionModuleService: IRegionModuleService =
+      container.resolve(ModuleRegistrationName.REGION)
+
+    const regions = await regionModuleService.list()
+  }
+  ```
+
+  </CodeTab>
+  <CodeTab label="Workflow Step" value="workflow-step">
+
+  ```ts title="src/workflows/hello-world/step1.ts"
+  import { createStep } from "@medusajs/workflows-sdk"
+  import { IRegionModuleService } from "@medusajs/types"
+  import { ModuleRegistrationName } from "@medusajs/modules-sdk"
+
+  const step1 = createStep("step-1", async (_, context) => {
+    const regionModuleService: IRegionModuleService =
+      context.container.resolve(
+        ModuleRegistrationName.REGION
+      )
+    
+    const regions = await regionModuleService.list()
+  })
+  ```
+
+  </CodeTab>
+</CodeTabs>

www/apps/resources/app/commerce-modules/region/relations-to-other-modules/page.mdx

@@ -0,0 +1,17 @@
+export const metadata = {
+  title: `Relations between Region Module and Other Modules`,
+}
+
+# {metadata.title}
+
+When Commerce Modules are used together in a Medusa application, the Medusa application handles building the relations between these modules.
+
+This document showcases the relation between the Region Module and other Commerce Modules.
+
+## Cart Module
+
+Carts are associated with a region. The Medusa application forms a relation between the `Region` and the `Cart` data models.
+
+![A diagram showcasing an example of how resources from the API Key and Sales Channel modules are linked](https://res.cloudinary.com/dza7lstvk/image/upload/v1711116934/Medusa%20Resources/region-cart_hffaib.jpg)
+
+The cart then uses the same currency as the region. During checkout, the cart's taxes, payment, and fulfillment providers are available based on the region's settings.