resolves mismatched in OpenAPI resource specs for type generation (#1239)

* fixes OpenAPI spec mismatches between require properties and available properties
* updating specs with feedback

Author: heckj

Sources/SwiftDocC/SwiftDocC.docc/Resources/LinkableEntities.json

@@ -570,7 +570,7 @@
                         "type": "string",
                         "enum": ["icon", "card"]
                     },
-                    "reference": {
+                    "identifier": {
                         "type": "string",
                         "format": "reference(ImageRenderReference)"
                     }

Sources/SwiftDocC/SwiftDocC.docc/Resources/RenderNode.spec.json

@@ -360,8 +360,7 @@
                 "type": "object",
                 "required": [
                     "kind",
-                    "tiles",
-                    "content"
+                    "tiles"
                 ],
                 "properties": {
                     "kind": {
@@ -526,8 +525,7 @@
                     "kind",
                     "content",
                     "media",
-                    "mediaPosition",
-                    "layout"
+                    "mediaPosition"
                 ],
                 "properties": {
                     "kind": {
@@ -1850,7 +1848,7 @@
                         "type": "string",
                         "enum": ["icon", "card"]
                     },
-                    "reference": {
+                    "identifier": {
                         "type": "string",
                         "format": "reference(ImageRenderReference)"
                     }
@@ -2011,7 +2009,7 @@
                         "type": "string",
                         "format": "reference(RenderReference)"
                     },
-                    "sections": {
+                    "kind": {
                         "type": "string",
                         "enum": ["task", "assessment", "heading"]
                     }
@@ -2547,7 +2545,6 @@
             },
             "MentionsRenderSection": {
                 "required": [
-                    "kind",
                     "mentions"
                 ],
                 "type": "object",