first draft

Author: Jo

docs/partials/inventory/overview.mdx

@@ -5,7 +5,7 @@ Inventory is the quantity of each product that you have in stock. The inventory
 You can manage inventory using both:
 
 - the [Inventories API](/docs/api/pxm/inventory)
-- [Commerce Manager](/docs/commerce-manager/product-experience-manager/Products/manage-product-inventory).
+- [Commerce Manager](/docs/commerce-manager/product-experience-manager/Products/manage-product-inventory)
 
 ### What is Inventory?
 

docs/partials/inventory/unpaidorder.mdx

@@ -6,8 +6,10 @@ The following flowchart shows the process for an unpaid order.
 Stock is managed as follows:
 
 1. When a customer attempts to add products to a cart, the inventory service checks if there is enough available stock. If there is not enough stock available, you receive a 400 HTTP response with a warning. The response does not describe what products cannot be added, nor does it return how many products are in stock.
-2. If a customer successfully adds products to a cart, the customer can checkout to create an unpaid order.
-3. A final check on the available stock is performed.
-4. After creating the unpaid order, the payment for an order can be taken. When a customer attempts to pay for an order, the inventory service reserves the stock before the payment is processed internally. At any time before the point of payment, a customer might lose their order, if the customer is slower than everyone else.
-5. If the payment fails, the temporary stock allocation is removed, and the stock becomes available again for anyone to buy.
+1. If a customer successfully adds products to a cart, the customer can optionally choose the location of the stock (if this order is for collection).
+1. The inventory service checks if there is enough available stock at the location.
+1. If there is enough stock available at the location, then the customer can checkout to create an unpaid order.
+1. A final check on the available stock is performed.
+1. After creating the unpaid order, the payment for an order can be taken. When a customer attempts to pay for an order, the inventory service reserves the stock before the payment is processed internally. At any time before the point of payment, a customer might lose their order, if the customer is slower than everyone else.
+1. If the payment fails, the temporary stock allocation is removed, and the stock becomes available again for anyone to buy.
 

guides/key-concepts/inventory/characteristcs.mdx

@@ -1,6 +1,6 @@
 ---
-title: Characteristics
-nav_label: Characteristics
+title: Inventory Characteristics
+nav_label: Inventory Characteristics
 sidebar_position: 30
 ---
 

guides/key-concepts/inventory/transactions.mdx

@@ -1,6 +1,6 @@
 ---
-title: Transactions
-nav_label: Transactions
+title: Inventory Transactions
+nav_label: Inventory Transactions
 sidebar_position: 20
 ---
 

guides/key-concepts/inventory/workflow/_category_.json

@@ -1,5 +1,5 @@
 {
   "position": 25,
-  "label": "Workflow",
+  "label": "Inventory Workflow",
   "collapsible": true
 }

guides/key-concepts/inventory/workflow/paidorder.mdx

@@ -1,7 +1,7 @@
 ---
 title: Paid Order Flow
 nav_label: Paid Order Flow
-sidebar_position: 10
+sidebar_position: 15
 ---
 
 import PaidOrder from "/docs/partials/inventory/paidorder.mdx";

guides/key-concepts/inventory/workflow/unpaidorder.mdx

@@ -1,9 +1,11 @@
 ---
 title: Unpaid Order Flow
 nav_label: Unpaid Order Flow
-sidebar_position: 15
+sidebar_position: 10
 ---
 
 import UnpaidOrder from "/docs/partials/inventory/unpaidorder.mdx";
 
 <UnpaidOrder></UnpaidOrder>
+
+Once payment is completed, the order transitions to a [paid order](/guides/key-concepts/inventory/workflow/paidorder), allowing further processing, such as fulfillment or shipping.

guides/key-concepts/inventory/workflow/workflow.mdx

@@ -1,9 +1,11 @@
 ---
-title: Overview
-nav_label: Overview
+title: Inventory Workflow
+nav_label: Inventory Workflow
 sidebar_position: 5
 ---
 
 import InventoryWorkflow from "/docs/partials/inventory/workflow.mdx";
 
 <InventoryWorkflow></InventoryWorkflow>
+
+The order service first creates an [unpaid order](/guides/key-concepts/inventory/workflow/unpaidorder), which records the order details and holds the items. Once payment is completed, the order transitions to a [paid order](/guides/key-concepts/inventory/workflow/paidorder), allowing further processing, such as fulfillment or shipping.