feat(schema): allow structured descriptions for exts, insts, profiles (#712)

Author: dhower-qc

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": {

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": {

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": {