Add missing example descriptions

Author: mcvinci

packages/ui-extensions/docs/surfaces/point-of-sale/reference/apis/order-api.doc.ts

@@ -58,6 +58,8 @@ Order data reflects the current POS session and may not include real-time update
           "Retrieve an order's name, ID, and associated customer ID",
           'order-details',
         ),
+        description:
+          'Access multiple order properties including the order name and customer ID. This example demonstrates accessing `shopify.order.id`, `shopify.order.name`, and `shopify.order.customerId` to display comprehensive order information, enabling order management workflows and customer service features.',
       },
     ],
   },

packages/ui-extensions/docs/surfaces/point-of-sale/reference/apis/pinpad-api.doc.ts

@@ -60,6 +60,8 @@ const data: ReferenceEntityTemplateSchema = {
           'Configure PinPad options and handle dismissal',
           'validation-with-options',
         ),
+        description:
+          'Configure PIN pad options including PIN length requirements, masking, and custom labels. This example shows how to use `showPinPad()` with options like `minPinLength`, `maxPinLength`, `masked`, `title`, and `onDismissed` callback to create a fully configured PIN entry experience with proper validation and dismissal handling.',
       },
     ],
   },

packages/ui-extensions/docs/surfaces/point-of-sale/reference/apis/product-api.doc.ts

@@ -36,6 +36,8 @@ const data: ReferenceEntityTemplateSchema = {
           'Retrieve product and product variant IDs',
           'product-variant',
         ),
+        description:
+          'Access both product and variant identifiers to implement variant-specific functionality. This example shows how to retrieve `shopify.product.id` and `shopify.product.variantId` together, enabling variant-aware features like inventory checks, variant-specific pricing, or detailed product information displays.',
       },
     ],
   },

packages/ui-extensions/docs/surfaces/point-of-sale/reference/apis/scanner-api.doc.ts

@@ -60,6 +60,8 @@ const data: ReferenceEntityTemplateSchema = {
           'Subscribe to scanner data events and track scanning history',
           'scanner-data-subscribe',
         ),
+        description:
+          'Subscribe to real-time scan events and maintain a history of scanned items. This example demonstrates using `shopify.scanner.scannerData.current.subscribe()` to capture scan data, source information, and timestamps, enabling features like scan logging, bulk scanning workflows, or scan history review.',
       },
     ],
   },

packages/ui-extensions/docs/surfaces/point-of-sale/reference/apis/session-api.doc.ts

@@ -59,6 +59,8 @@ const data: ReferenceEntityTemplateSchema = {
           'Access properties associated with the current session',
           'current-session',
         ),
+        description:
+          'Access comprehensive session information including shop details, user data, and location information. This example shows how to use `shopify.session.currentSession` to retrieve shop ID, domain, currency, user ID, location ID, staff member ID, and POS version, enabling location-aware features and personalized experiences.',
       },
     ],
   },

packages/ui-extensions/docs/surfaces/point-of-sale/reference/apis/toast-api.doc.ts

@@ -59,6 +59,8 @@ const data: ReferenceEntityTemplateSchema = {
           'Display a toast notification for a custom duration',
           'show-with-duration',
         ),
+        description:
+          'Configure custom display durations for toast notifications to match message importance and length. This example demonstrates using the `duration` option with `shopify.toast.show()` to control how long notifications remain visible, from quick 2-second confirmations to longer 8-second messages that require more reading time.',
       },
     ],
   },