diff --git a/unified-runtime/include/ur_api.h b/unified-runtime/include/ur_api.h
index 99ef08162eb90..5a12aa3eb25d6 100644
--- a/unified-runtime/include/ur_api.h
+++ b/unified-runtime/include/ur_api.h
@@ -1820,7 +1820,9 @@ typedef struct ur_device_binary_t {
 typedef enum ur_device_type_t {
   /// The default device type as preferred by the runtime
   UR_DEVICE_TYPE_DEFAULT = 1,
-  /// Devices of all types
+  /// Devices of all types, for use with ::urDeviceGet() and
+  /// ::urDeviceGetSelected(). This value will never be returned when
+  /// querying about a device.
   UR_DEVICE_TYPE_ALL = 2,
   /// Graphics Processing Unit
   UR_DEVICE_TYPE_GPU = 3,
diff --git a/unified-runtime/scripts/core/device.yml b/unified-runtime/scripts/core/device.yml
index bd8553ae8adb3..a0c93262eb732 100644
--- a/unified-runtime/scripts/core/device.yml
+++ b/unified-runtime/scripts/core/device.yml
@@ -94,7 +94,10 @@ etors:
       value: "1"
       desc: "The default device type as preferred by the runtime"
     - name: ALL
-      desc: "Devices of all types"
+      desc: |
+            Devices of all types, for use with $xDeviceGet() and 
+            $xDeviceGetSelected(). This value will never be returned when
+            querying about a device.
     - name: GPU
       desc: "Graphics Processing Unit"
     - name: CPU
diff --git a/unified-runtime/scripts/core/manifests.yml b/unified-runtime/scripts/core/manifests.yml
index 42a28b9a1f369..6b9647852daea 100644
--- a/unified-runtime/scripts/core/manifests.yml
+++ b/unified-runtime/scripts/core/manifests.yml
@@ -8,7 +8,7 @@
 # See YaML.md for syntax definition
 #
 # NOTE: device_types must be explictly listed. Refrain from using 
-#       $X_DEVICE_TYPE_ALL. See https://github.com/intel/llvm/issues/17527.
+#       $X_DEVICE_TYPE_ALL.
 --- #--------------------------------------------------------------------------
 type: header
 desc: "Intel $OneApi Unified Runtime adapter manifests"