From efe7ec6629a2056cda04c491765bd41cb2d1f9b6 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 27 Jul 2026 16:49:50 +0000
Subject: [PATCH 1/2] Initial plan


From 74d0e2ce76be36ef41e891dd7380f5ab0c0baaa2 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 27 Jul 2026 16:52:00 +0000
Subject: [PATCH 2/2] docs: add unit, coordinate system, and HID spec details
 to LampInfo.Position and LampArray.BoundingBox

---
 windows.devices.lights/lamparray_boundingbox.md |  7 +++++++
 windows.devices.lights/lampinfo_position.md     | 13 +++++++++++--
 2 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/windows.devices.lights/lamparray_boundingbox.md b/windows.devices.lights/lamparray_boundingbox.md
index 4b11e0a2df..7f3d68c587 100644
--- a/windows.devices.lights/lamparray_boundingbox.md
+++ b/windows.devices.lights/lamparray_boundingbox.md
@@ -23,8 +23,15 @@ The value of the bounding box.
 
 Values are measured in meters.
 
+The coordinate system is left-handed, with the origin at the front-top-left corner of the bounding box:
+- **+X** extends to the right.
+- **+Y** extends downward.
+- **+Z** extends away from the user (into the device).
+
 Origin of [Positions](lampinfo_position.md) is the upmost, top, left corner of the box.
 
+Bounding box extents are derived from the device's HID LampArray descriptor, which reports dimensions in micrometers (µm). The WinRT API converts these values to meters (µm ÷ 1,000,000).
+
 ## -examples
 
 :::row:::
diff --git a/windows.devices.lights/lampinfo_position.md b/windows.devices.lights/lampinfo_position.md
index a8a2a2e662..4c18b3ddd1 100644
--- a/windows.devices.lights/lampinfo_position.md
+++ b/windows.devices.lights/lampinfo_position.md
@@ -11,14 +11,23 @@ public Vector3 Position { get; }
 # Windows.Devices.Lights.LampInfo.Position
 
 ## -description
-3D position of the lamp relative to the origin of the bounding-box.
+Gets the position of the lamp within the lamp array, expressed in meters relative to the front-top-left corner of the array's bounding box.
 
 ## -property-value
-The position of the lamp.
+A [Vector3](/dotnet/api/system.numerics.vector3) representing the lamp's position in meters, where X is the horizontal offset (increasing to the right), Y is the vertical offset (increasing downward), and Z is the depth offset (increasing away from the user).
 
 ## -remarks
+Position values are expressed in meters. The coordinate system is left-handed:
+- **+X** extends to the right.
+- **+Y** extends downward.
+- **+Z** extends away from the user (into the device).
+
+The origin (0, 0, 0) corresponds to the front-top-left corner of the device's bounding box (see [LampArray.BoundingBox](lamparray_boundingbox.md)).
+
+Position values are derived from the device's HID LampArray descriptor, which reports positions in micrometers (µm). The WinRT API converts these values to meters (µm ÷ 1,000,000) before exposing them as a [Vector3](/dotnet/api/system.numerics.vector3).
 
 ## -see-also
+[LampArray.BoundingBox](lamparray_boundingbox.md), [Lighting and Illumination (www.usb.org)](https://www.usb.org/sites/default/files/hutrr84_-_lighting_and_illumination_page.pdf), [Dynamic lighting](/windows/uwp/devices-sensors/lighting-dynamic-lamparray)
 
 ## -examples