chore: testing child node description and docs link

Author: DmitryAnansky

packages/core/src/types/arazzo.ts

@@ -38,7 +38,11 @@ const Info: NodeType = {
   properties: {
     title: { type: 'string' },
     description: { type: 'string' },
-    summary: { type: 'string' },
+    summary: {
+      type: 'string',
+      description: `The object provides metadata about API workflows defined in this Arazzo document. The metadata MAY be used by the clients if needed.`,
+      documentationLink: `https://spec.openapis.org/arazzo/latest.html#info-object`,
+    },
     version: { type: 'string' },
   },
   required: ['title', 'version'],

packages/core/src/types/oas3.ts

@@ -179,8 +179,16 @@ const Operation: NodeType = {
       type: 'array',
       items: { type: 'string' },
     },
-    summary: { type: 'string' },
-    description: { type: 'string' },
+    summary: {
+      type: 'string',
+      description: `Optional short summary of what the operation does.`,
+      documentationLink: `https://spec.openapis.org/oas/v3.1.0#operation-object`,
+    },
+    description: {
+      type: 'string',
+      description: `Optional description of the operation and its behavior. Supports Markdown formatting. Redocly tools support using $ref in this field to reuse or include content from other sources.`,
+      documentationLink: `https://spec.openapis.org/oas/v3.1.0#operation-object`,
+    },
     externalDocs: 'ExternalDocs',
     operationId: { type: 'string' },
     parameters: 'ParameterList',

packages/core/src/types/oas3_1.ts

@@ -66,8 +66,16 @@ const Operation: NodeType = {
       type: 'array',
       items: { type: 'string' },
     },
-    summary: { type: 'string' },
-    description: { type: 'string' },
+    summary: {
+      type: 'string',
+      description: `Optional short summary of what the operation does.`,
+      documentationLink: `https://spec.openapis.org/oas/v3.1.0#operation-object`,
+    },
+    description: {
+      type: 'string',
+      description: `Optional description of the operation and its behavior. Supports Markdown formatting. Redocly tools support using $ref in this field to reuse or include content from other sources.`,
+      documentationLink: `https://spec.openapis.org/oas/v3.1.0#operation-object`,
+    },
     externalDocs: 'ExternalDocs',
     operationId: { type: 'string' },
     parameters: 'ParameterList',