MSI-1861 extend README files for all inventory modules

app/code/Magento/Inventory/README.md

@@ -1,5 +1,21 @@
-# Inventory
+# Inventory module
 
-**Inventory** provides implementation for inventory management.
-See [concept documentation](https://github.com/magento-engcom/magento2/wiki/Technical-Vision.-Catalog-Inventory)
-for further information.
+The `Inventory` module module is part of the MSI (Multi-Source Inventory) project,
+which replaces the legacy `CatalogInventory` module with new and expanded features and APIs for Inventory Management.  
+
+The [Inventory Management overview](https://devdocs.magento.com/guides/v2.3/inventory/index.html)
+describes the MSI project in more detail.
+
+All Inventory Management modules follow the 
+[Single Responsibility Principle](https://en.wikipedia.org/wiki/Single_responsibility_principle).
+[Inventory management architecture](https://devdocs.magento.com/guides/v2.3/inventory/architecture.html) 
+provides additional insight about the overall structure of these modules.
+
+## Installation details
+
+This module is installed as part of Magento Open Source. It cannot be deleted or disabled.
+
+## Extension points and service contracts
+
+All public interfaces related to this module are located in the `InventoryApi` module. 
+Use the interfaces defined in `InventoryApi` to extend this module.

app/code/Magento/InventoryAdminUi/README.md

@@ -1,5 +1,23 @@
-# InventoryAdminUi
+# InventoryAdminUi module
 
-**InventoryAdminUi** provides implementation for inventory management interface.
-See [concept documentation](https://github.com/magento-engcom/magento2/wiki/Technical-Vision.-Catalog-Inventory)
-for further information.
+The `InventoryAdminUi` module extends the Magento Admin UI to add Inventory Management functionality.
+
+This module is part of the MSI (Multi-Source Inventory) project. The 
+[Inventory Management overview](https://devdocs.magento.com/guides/v2.3/inventory/index.html)
+describes the MSI project in more detail.
+
+## Installation details
+
+This module is installed as part of Magento Open Source. You can remove it if you run a headless version of Magento.
+
+## Extensibility
+
+The `InventoryAdminUi` module contains several extension points.
+
+### Layouts
+
+You can extend and override layouts defined in the `view/adminhtml/layout`  directory.
+
+### UI Components
+
+The `view/adminhtml/ui_component` directory contains extensible UI components.

app/code/Magento/InventoryApi/README.md

@@ -1,5 +1,23 @@
-# InventoryApi
+# InventoryApi module
 
-**InventoryApi** provides interfaces for inventory management.
-See [concept documentation](https://github.com/magento-engcom/magento2/wiki/Technical-Vision.-Catalog-Inventory)
-for further information.
+The `InventoryApi` module provides Inventory Management service contracts. 
+
+This module is part of the MSI (Multi-Source Inventory) project. The 
+[Inventory Management overview](https://devdocs.magento.com/guides/v2.3/inventory/index.html)
+describes the MSI project in more detail.
+
+## Installation details
+
+This module is installed as part of Magento Open Source. It cannot be deleted or disabled.
+
+## Extensibility
+
+The `InventoryApi` module contains several extension points.
+
+### Public APIs
+
+Public APIs are defined in the `Api` and `Api/Data` directories.
+
+### REST endpoints
+
+The `etc/webapi.xml` file defines endpoints for managing sources, stocks, stock source links, and source items.

app/code/Magento/InventoryBundleProduct/README.md

@@ -1 +1,15 @@
-# InventoryBundleProduct
+# InventoryBundleProduct module
+
+The `InventoryBundleProduct` module integrates inventory management business logic into Magento's bundle product logic.
+
+This module is part of the MSI (Multi-Source Inventory) project. The 
+[Inventory Management overview](https://devdocs.magento.com/guides/v2.3/inventory/index.html)
+describes the MSI project in more detail.
+
+## Installation details
+
+This module is installed as part of Magento Open Source. It cannot be deleted or disabled.
+
+## Extension points and service contracts
+
+There are no extension points or service contracts for this module.

app/code/Magento/InventoryBundleProductAdminUi/README.md

@@ -1 +1,15 @@
-# InventoryBundleProductAdminUi
+# InventoryBundleProductAdminUi module
+
+The `InventoryBundleProductAdminUi`extends the Magento Admin UI to add MSI functionality.
+
+This module is part of the MSI (Multi-Source Inventory) project. The 
+[Inventory Management overview](https://devdocs.magento.com/guides/v2.3/inventory/index.html)
+describes the MSI project in more detail.
+
+## Installation details
+
+This module is installed as part of Magento Open Source. You can remove it if you run a headless version of Magento.
+
+## Extensibility
+
+There are no extension points or for this module.

app/code/Magento/InventoryCache/README.md

@@ -1,4 +1,15 @@
-# Inventory
+# InventoryCache module
 
-**InventoryCache**
+The `InventoryCache` module integrates inventory management business logic into Magento's cache logic.
 
+This module is part of the MSI (Multi-Source Inventory) project. The 
+[Inventory Management overview](https://devdocs.magento.com/guides/v2.3/inventory/index.html)
+describes the MSI project in more detail.
+
+## Installation details
+
+This module is installed as part of Magento Open Source. It cannot be deleted or disabled.
+
+## Extension points and service contracts
+
+There are no extension points or service contracts for this module.

app/code/Magento/InventoryCatalog/README.md

@@ -1,6 +1,16 @@
 # InventoryCatalog
 
-**InventoryCatalog** provides implementation for bridge between **Inventory** and **Catalog**.
-This is dedicated module which add logic to Default Role of the Source on installations with single source/stock. 
-See [concept documentation](https://github.com/magento-engcom/magento2/wiki/Technical-Vision.-Catalog-Inventory)
-for further information.
+The `InventoryCatalog` module integrates inventory management business logic into Magento's catalog logic.
+
+This module is part of the MSI (Multi-Source Inventory) project. The 
+[Inventory Management overview](https://devdocs.magento.com/guides/v2.3/inventory/index.html)
+describes the MSI project in more detail.
+
+## Installation details
+
+This module is installed as part of Magento Open Source. It cannot be deleted or disabled.
+
+## Extension points and service contracts
+
+All public interfaces related to this module are located in the `InventoryCatalogApi` module. 
+Use the interfaces defined in `InventoryCatalogApi` to extend this module.

app/code/Magento/InventoryCatalogAdminUi/README.md

@@ -1,2 +1,23 @@
-# InventoryCatalogAdminUi
+# InventoryCatalogAdminUi module
 
+The `InventoryCatalogAdminUi` module extends the Magento Admin UI to add MSI functionality.
+
+This module is part of the MSI (Multi-Source Inventory) project. The 
+[Inventory Management overview](https://devdocs.magento.com/guides/v2.3/inventory/index.html)
+describes the MSI project in more detail.
+
+## Installation details
+
+This module is installed as part of Magento Open Source. You can remove it if you run a headless version of Magento.
+
+## Extensibility
+
+The `InventoryCatalogAdminUi` module contains several extension points.
+
+### Layouts
+
+You can extend and override layouts defined in the `view/adminhtml/layout`  directory.
+
+### UI Components
+
+The `view/adminhtml/ui_component` directory contains extensible UI components.

app/code/Magento/InventoryCatalogApi/README.md

@@ -1,6 +1,23 @@
-# InventoryCatalog
+# InventoryCatalogApi module
 
-**InventoryCatalog** provides implementation for bridge between **Inventory** and **Catalog**.
-This is dedicated module which add logic to Default Role of the Source on installations with single source/stock. 
-See [concept documentation](https://github.com/magento-engcom/magento2/wiki/Technical-Vision.-Catalog-Inventory)
-for further information.
+The `InventoryCatalogApi` module provides service contracts for default source and stock providers as well as bulk operations. 
+
+This module is part of the MSI (Multi-Source Inventory) project. The 
+[Inventory Management overview](https://devdocs.magento.com/guides/v2.3/inventory/index.html)
+describes the MSI project in more detail.
+
+## Installation details
+
+This module is installed as part of Magento Open Source. It cannot be deleted or disabled.
+
+## Extensibility
+
+The `InventoryCatalogApi` module contains several extension points.
+
+### Public APIs
+
+Public APIs are defined in the `Api` directory.
+
+### REST endpoints
+
+The `etc/webapi.xml` file defines endpoints for assigning, unassigning, and transferring sources in bulk.

app/code/Magento/InventoryCatalogSearch/README.md

@@ -1,3 +1,15 @@
-# InventoryCatalogSearch
+# InventoryCatalogSearch module
 
-**InventoryCatalogSearch** adapts CatalogSearch to proper work with Inventory.
+The `InventoryCatalogSearch` module integrates inventory management business logic into Magento's search logic.
+
+This module is part of the MSI (Multi-Source Inventory) project. The 
+[Inventory Management overview](https://devdocs.magento.com/guides/v2.3/inventory/index.html)
+describes the MSI project in more detail.
+
+## Installation details
+
+This module is installed as part of Magento Open Source. It cannot be deleted or disabled.
+
+## Extension points and service contracts
+
+There are no extension points or service contracts for this module.

app/code/Magento/InventoryConfigurableProduct/README.md

@@ -1 +1,15 @@
-# InventoryConfigurableProduct
+## InventoryConfigurableProduct module
+
+The `InventoryConfigurableProduct` module integrates inventory management business logic into Magento's configurable product logic.
+
+This module is part of the MSI (Multi-Source Inventory) project. The 
+[Inventory Management overview](https://devdocs.magento.com/guides/v2.3/inventory/index.html)
+describes the MSI project in more detail.
+
+## Installation details
+
+This module is installed as part of Magento Open Source. It cannot be deleted or disabled.
+
+## Extension points and service contracts
+
+There are no extension points or service contracts for this module.

app/code/Magento/InventoryConfigurableProductAdminUi/README.md

@@ -1 +1,19 @@
-# InventoryConfigurableProductAdminUi
+# InventoryConfigurableProductAdminUi module
+
+The `InventoryConfigurableProductAdminUi`extends the Magento Admin UI to add inventory management functionality.
+
+This module is part of the MSI (Multi-Source Inventory) project. The 
+[Inventory Management overview](https://devdocs.magento.com/guides/v2.3/inventory/index.html)
+describes the MSI project in more detail.
+
+## Installation details
+
+This module is installed as part of Magento Open Source. You can remove it if you run a headless version of Magento.
+
+## Extensibility
+
+The `InventoryConfigurableProductAdminUi` module contains several extension points.
+
+### UI Components
+
+The `view/adminhtml/ui_component` directory contains extensible UI components.

app/code/Magento/InventoryConfigurableProductIndexer/README.md

@@ -1 +1,15 @@
-# InventoryConfigurableProductIndexer
+# InventoryConfigurableProductIndexer module
+
+The `InventoryConfigurableProductIndexer` module integrates inventory management business logic into Magento's indexation logic for configurable products.
+
+This module is part of the MSI (Multi-Source Inventory) project. The 
+[Inventory Management overview](https://devdocs.magento.com/guides/v2.3/inventory/index.html)
+describes the MSI project in more detail.
+
+## Installation details
+
+This module is installed as part of Magento Open Source. It cannot be deleted or disabled.
+
+## Extension points and service contracts
+
+There are no extension points or service contracts for this module.

app/code/Magento/InventoryConfiguration/README.md

@@ -1 +1,16 @@
-# InventoryConfiguration
+# InventoryConfiguration module
+
+The `InventoryConfiguration` module implements logic for inventory management configuration.
+
+This module is part of the MSI (Multi-Source Inventory) project. The 
+[Inventory Management overview](https://devdocs.magento.com/guides/v2.3/inventory/index.html)
+describes the MSI project in more detail.
+
+## Installation details
+
+This module is installed as part of Magento Open Source. It cannot be deleted or disabled.
+
+## Extension points and service contracts
+
+All public interfaces related to this module are located in the `InventoryConfigurationApi` module. 
+Use the interfaces defined in `InventoryConfigurationApi` to extend this module.

app/code/Magento/InventoryConfigurationApi/README.md

@@ -1 +1,19 @@
-# InventoryConfigurationApi
+# InventoryConfigurationApi module
+
+The `InventoryConfigurationApi` module provides service contracts for inventory management configuration.
+
+This module is part of the MSI (Multi-Source Inventory) project. The 
+[Inventory Management overview](https://devdocs.magento.com/guides/v2.3/inventory/index.html)
+describes the MSI project in more detail.
+
+## Installation details
+
+This module is installed as part of Magento Open Source. It cannot be disabled.
+
+## Extensibility
+
+The `InventoryConfigurationApi` module contains several extension points.
+
+### Public APIs
+
+Public APIs are defined in the `Api` and `Api/Data` directories.

app/code/Magento/InventoryGroupedProduct/README.md

@@ -1 +1,15 @@
-# InventoryGroupedProduct
+# InventoryGroupedProduct module
+
+The `InventoryGroupedProduct` module integrates inventory management business logic into Magento's grouped product logic.
+
+This module is part of the MSI (Multi-Source Inventory) project. The 
+[Inventory Management overview](https://devdocs.magento.com/guides/v2.3/inventory/index.html)
+describes the MSI project in more detail.
+
+## Installation details
+
+This module is installed as part of Magento Open Source. It cannot be deleted or disabled.
+
+## Extension points and service contracts
+
+There are no extension points or service contracts for this module.

app/code/Magento/InventoryGroupedProductAdminUi/README.md

@@ -1 +1,15 @@
-# InventoryGroupedProductAdminUi
+# InventoryGroupedProductAdminUi module
+
+The `InventoryGroupedProductAdminUi` module extends Magento's admin UI with inventory management functionality.
+
+This module is part of the MSI (Multi-Source Inventory) project. The 
+[Inventory Management overview](https://devdocs.magento.com/guides/v2.3/inventory/index.html)
+describes the MSI project in more detail.
+
+## Installation details
+
+This module is installed as part of Magento Open Source. You can remove it if you run a headless version of Magento.
+
+## Extension points and service contracts
+
+There are no extension points or service contracts for this module.

app/code/Magento/InventoryGroupedProductIndexer/README.md

@@ -1 +1,15 @@
-# InventoryGroupedProductIndexer
+# InventoryGroupedProductIndexer module
+
+The `InventoryGroupedProductIndexer` module integrates inventory management business logic into Magento's indexation logic for grouped products.
+
+This module is part of the MSI (Multi-Source Inventory) project. The 
+[Inventory Management overview](https://devdocs.magento.com/guides/v2.3/inventory/index.html)
+describes the MSI project in more detail.
+
+## Installation details
+
+This module is installed as part of Magento Open Source. It cannot be deleted or disabled.
+
+## Extension points and service contracts
+
+There are no extension points or service contracts for this module.

app/code/Magento/InventoryImportExport/README.md

@@ -1,6 +1,19 @@
-# InventoryCatalog
+# InventoryImportExport module
 
-**InventoryCatalog** provides implementation for bridge between **Inventory** and **Catalog**.
-This is dedicated module which add logic to Default Role of the Source on installations with single source/stock. 
-See [concept documentation](https://github.com/magento-engcom/magento2/wiki/Technical-Vision.-Catalog-Inventory)
-for further information.
+The `InventoryImportExport` module provides compatibility between Magento's flat file import/export logic and Inventory Management.
+
+This module is part of the MSI (Multi-Source Inventory) project. The 
+[Inventory Management overview](https://devdocs.magento.com/guides/v2.3/inventory/index.html)
+describes the MSI project in more detail.
+
+## Installation details
+
+This module is installed as part of Magento Open Source. It cannot be deleted or disabled.
+
+## Extension points and service contracts
+
+There are no extension points or service contracts for this module.
+
+## Additional information
+
+The `files/sample/stock_sources.csv` file is a template for importing inventory into the system.