docs: add documentation for v1.8 (#3669)

docs/content/user-guide/multiwarehouse/_category_.json

@@ -0,0 +1,9 @@
+{
+  "position": 5,
+  "collapsed": false,
+  "link": null,
+  "label": "Multi-Warehouse",
+  "customProps": {
+    "sidebar_is_group_headline": true
+  }
+}

docs/content/user-guide/multiwarehouse/index.md

@@ -0,0 +1,32 @@
+---
+sidebar_position: 1
+description: "Multi-warehouse allows you to define multiple locations that your stock items are available in. In the Medusa admin, you can manage the store's inventory and location."
+---
+
+# Multi-Warehouse Overview
+
+In this document, you’ll get an overview of the multi-warehouse setup and how you can use it in the Medusa admin.
+
+:::note
+
+Multi-warehouse requires the Inventory and Stock Location modules to be installed. If you’re unsure how to handle that, please contact your technical team for support.
+
+:::
+
+## Overview
+
+Multi-warehouse allows you to define multiple locations that your stock items are available in. You can then specify for each of these locations the quantity of the item. You can also associate locations with multiple [Sales Channels](../sales-channels/index.md).
+
+When fulfilling an order, you can select the location to fulfill the items from. Similarly, when requesting or handling a return, you can select the location to return the item to. This will automatically increment or decrement the quantity as necessary.
+
+It should be noted that the following are not explained within this section of the user guide:
+
+- Item allocation and locations in orders: this is explained in the [Orders section](../orders/manage.mdx).
+- Managing general inventory of a product variant: this is explained in the [Products section](../products/manage.mdx).
+
+---
+
+## Learn More About Multi-Warehouse
+
+- [Manage Inventory](./inventory.mdx)
+- [Manage Locations](./locations.mdx)

docs/content/user-guide/multiwarehouse/inventory.mdx

@@ -0,0 +1,30 @@
+---
+sidebar_position: 2
+description: "This user guide explains how to manage inventory in the Medusa Admin. Learn how to check and change a variant's quantity in a location."
+addHowToData: true
+---
+
+import UiIcon from '@site/src/components/UiIcon';
+
+# Manage Inventory
+
+In this document, you’ll learn how to manage inventory in the Medusa Admin.
+
+## Check Inventory
+
+To check your store’s inventory, go to the Inventory page. Here, you’ll see the available inventory of product variants in a location.
+
+You can switch locations from the select field above the table of inventory. You can also search products through the search field above the table of inventory.
+
+---
+
+## Change Variant Inventory
+
+To change a product variant’s inventory in a location:
+
+1. Go to the Inventory page.
+2. Choose the location you want to change the inventory in from the select field above the table.
+3. Find the product variant you want to change its quantity, then click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at its right.
+4. Choose “Adjust Availability” from the dropdown.
+5. In the new window that opens, change the quantity of the variant.
+6. Once done, click on the “Save and close” button.

docs/content/user-guide/multiwarehouse/locations.mdx

@@ -0,0 +1,80 @@
+---
+sidebar_position: 3
+description: "This user guide explains how to manage inventory in the Medusa Admin. Learn how to check and change a variant's quantity in a location."
+addHowToData: true
+---
+
+import UiIcon from '@site/src/components/UiIcon';
+
+# Manage Locations
+
+In this document, you’ll learn how to manage the stock locations using the Medusa admin.
+
+## Create a Location
+
+To create a location:
+
+1. Go to the Inventory page.
+2. Click on the Locations header at the top of the section.
+3. Click on the “Add location” button at the top right.
+4. In the new form that opens:
+    1. Enter the location name.
+    2. Optionally, enter the address details of the location.
+    3. To associate this location with sales channels:
+        1. Click on the Sales Channels collapsible.
+        2. Click on the “Add sales channels” button.
+        3. In the new window that opens:
+            1. Click on the “Add Channels” button.
+            2. Choose the channels you want to add.
+            3. Click the “Save and close” button.
+5. Once you’re done, click on the “Add location” button.
+
+---
+
+## Edit a Location
+
+To edit a location:
+
+1. Go to the Inventory page.
+2. Click on the Locations header at the top of the section.
+3. Find the location you want to edit and click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at its right.
+4. Choose “Edit details” from the dropdown.
+5. Edit any of the location’s details.
+6. Once you’re done, click the “Save and close” button.
+
+---
+
+## Edit Sales Channels of a Location
+
+To edit the sales channels of a location:
+
+1. Go to the Inventory page.
+2. Click on the Locations header at the top of the section.
+3. Find the location you want to edit its sales channels, and click on the “Edit channels” button.
+4. In the new window that opens:
+    1. To remove an association to a sales channel:
+        1. Click on the checkbox next to the sales channel.
+        2. Click on the Remove button.
+    2. To associate a sales channel:
+        1. Click on the “Add Channels” button.
+        2. Choose the channels you want to add.
+        3. Click the “Save and go back” button.
+5. Once you’re done, click the Close button.
+
+---
+
+## Delete a Location
+
+:::warning
+
+Deleting a location can’t be undone, and its data can’t be restored.
+
+:::
+
+To delete a location:
+
+1. Go to the Inventory page.
+2. Click on the Locations header at the top of the section.
+3. Find the location you want to delete and click on the <UiIcon lightIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999308/Medusa%20Docs/UI%20Icons/1ordBC6_ssysel.png" darkIcon="https://res.cloudinary.com/dza7lstvk/image/upload/v1667999326/Medusa%20Docs/UI%20Icons/dSwWYBH_stzgoi.png" alt="three dots" /> icon at its right.
+4. Choose “Delete” from the dropdown.
+5. Enter the name of the location then click the “Yes, confirm” button.