From 6efd1eef118afcfb5bc12725242700001d00f5b4 Mon Sep 17 00:00:00 2001
From: Derek Hower <dhower@qti.qualcomm.com>
Date: Thu, 1 May 2025 07:15:35 -0700
Subject: [PATCH] feat(schema): allow structured descriptions for extensions,
 instructions, profiles

---
 schemas/ext_schema.json           | 4 ++--
 schemas/inst_schema.json          | 2 +-
 schemas/profile_class_schema.json | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/schemas/ext_schema.json b/schemas/ext_schema.json
index 138830c86..7e464c8eb 100644
--- a/schemas/ext_schema.json
+++ b/schemas/ext_schema.json
@@ -37,7 +37,7 @@
       "required": ["description", "schema"],
       "properties": {
         "description": {
-          "type": "string",
+          "$ref": "schema_defs.json#/$defs/spec_text",
           "description": "Parameter description, including list of valid values"
         },
         "also_defined_in": {
@@ -97,7 +97,7 @@
           "pattern": ".*[^.!,]$"
         },
         "description": {
-          "type": "string",
+          "$ref": "schema_defs.json#/$defs/spec_text",
           "description": "Full documentation of the extension"
         },
         "rvi_jira_issue": {
diff --git a/schemas/inst_schema.json b/schemas/inst_schema.json
index f28168ba1..f46b7649f 100644
--- a/schemas/inst_schema.json
+++ b/schemas/inst_schema.json
@@ -184,7 +184,7 @@
           "pattern": ".*[^.!,]$"
         },
         "description": {
-          "type": "string",
+          "$ref": "schema_defs.json#/$defs/spec_text",
           "description": "Detailed description of the instruction"
         },
         "definedBy": {
diff --git a/schemas/profile_class_schema.json b/schemas/profile_class_schema.json
index 663b65cb3..cf34f223c 100644
--- a/schemas/profile_class_schema.json
+++ b/schemas/profile_class_schema.json
@@ -30,7 +30,7 @@
       "description": "Asciidoc text containing the introduction prose for the class"
     },
     "description": {
-      "type": "string",
+      "$ref": "schema_defs.json#/$defs/spec_text",
       "description": "Asciidoc text containing longer description prose for the class"
     },
     "naming_scheme": {