Merge branch 'main' into migrate-services-topics

Author: keharper

src/pages/starter-kit/checkout/development.md

@@ -88,7 +88,7 @@ For debugging applications created with the starter kit, refer to the [App Build
 
 ## Testing
 
-The testing framework is in [Jest](https://jestjs.io) and execution is based on the [`aio` CLI](https://developer.adobe.com/runtime/docs/guides/tools/cli_install/).
+The testing framework is in [Jest](https://jestjs.io) and execution is based on the [`aio` CLI](https://developer.adobe.com/app-builder/docs/guides/runtime_guides/tools/cli-install).
 
 Run unit tests for the UI and actions:
 

src/pages/starter-kit/checkout/getting-started.md

@@ -24,7 +24,7 @@ You must install or have access to the following prerequisites to develop with t
   nvm install 22 && nvm use
   ```
 
-- [Adobe I/O CLI](https://developer.adobe.com/runtime/docs/guides/tools/cli_install/).
+- [Adobe I/O CLI](https://developer.adobe.com/app-builder/docs/guides/runtime_guides/tools/cli-install).
 
 - Access to the [Adobe Developer Console](https://console.adobe.io/) with an App
   Builder license. If you do not have access to the Adobe Developer Console or App Builder, refer to [get access to App Builder](https://developer.adobe.com/app-builder/docs/overview/getting_access/#get-access-to-app-builder).

src/pages/starter-kit/checkout/tax-use-cases.md

@@ -204,3 +204,29 @@ Here's an example payload showing how the custom attributes from tax classes app
   }
 }
 ```
+
+## Propagate custom attributes of tax classes
+
+The out-of-process tax module introduces support for assigning serialized custom attributes to tax classes. These attributes are then automatically associated with shopping cart data during cart creation and product addition. This allows for tax-related metadata to be included early in the checkout process and carried forward into subsequent operations.
+
+### How it works
+
+- **Customer Tax Class > Quote**:  
+  When a customer creates a shopping cart, any serialized custom attributes associated with the customer's tax class are copied to the `Quote` entity.
+
+- **Product Tax Class > Quote Item**:  
+  When a product is added to the cart, serialized custom attributes from the product's tax class are copied to the corresponding `Quote Item`.
+
+This ensures that both the `Quote` and each `Quote Item` contain tax-relevant custom data for further processing or integration.
+
+### Quote to Order propagation
+
+Once the customer places an order, all serialized custom attributes already present in the `Quote` and `Quote Item` entities are automatically propagated to the `Order` and `Order Item` entities, respectively.
+
+This propagation ensures that tax class metadata—initially attached by customer and product associations—is consistently preserved throughout the entire checkout lifecycle. This allows external systems (such as tax calculation services) to access the tax class and its serialized custom attributes using:
+
+- REST APIs
+- GraphQL queries
+- Event-driven integrations using Adobe Commerce Eventing
+
+This consistency is critical for third-party integrations that rely on tax classification metadata for compliance, reporting, or invoicing purposes.