diff --git a/src/openrpc/device.json b/src/openrpc/device.json
index e8604bb56..ba36ad3a4 100644
--- a/src/openrpc/device.json
+++ b/src/openrpc/device.json
@@ -334,7 +334,7 @@
     },
     {
       "name": "hdcp",
-      "summary": "Get the supported HDCP profiles",
+      "summary": "Get the negotiated HDCP profiles for a connected device. \n\n For devices that do not require additional connections (e.g. panels), `true` will be returned for all profiles.",
       "params": [],
       "tags": [
         {
@@ -370,7 +370,7 @@
     },
     {
       "name": "hdr",
-      "summary": "Get the supported HDR profiles",
+      "summary": "Get the negotiated HDR formats for the connected display and device",
       "params": [],
       "tags": [
         {
@@ -912,7 +912,7 @@
           },
           "firmware": {
             "$ref": "https://meta.comcast.com/firebolt/types#/definitions/SemanticVersion",
-            "description": "The device firmware version."
+            "description": "The firmware version as reported by the device"
           },
           "os": {
             "$ref": "https://meta.comcast.com/firebolt/types#/definitions/SemanticVersion",
@@ -920,7 +920,7 @@
           },
           "debug": {
             "type": "string",
-            "description": "Detail version as a string, for debugging purposes"
+            "description": "Detailed version as a string, for debugging purposes"
           }
         },
         "required": [