Merge pull request #4966 from karenetheridge/ether/xml-deprecations

updates for the "xml" and "example" keywords

Author: lornajane

src/oas.md

@@ -3819,8 +3819,8 @@ When using a Schema Object with XML, if no XML Object is present, the behavior i
 | <a name="xml-name"></a>name | `string` | Sets the name of the element/attribute corresponding to the schema, replacing the name that was inferred as described under [XML Node Names](#xml-node-names). This field SHALL be ignored if the `nodeType` is `text`, `cdata`, or `none`. |
 | <a name="xml-namespace"></a>namespace | `string` | The IRI ([[RFC3987]]) of the namespace definition. Value MUST be in the form of a non-relative IRI. |
 | <a name="xml-prefix"></a>prefix | `string` | The prefix to be used for the [name](#xml-name). |
-| <a name="xml-attribute"></a>attribute | `boolean` | Declares whether the property definition translates to an attribute instead of an element. Default value is `false`. If `nodeType` is present, this field MUST NOT be present.<br /><br />**Deprecated:** Use `nodeType: "attribute"` in place of `attribute: true` |
-| <a name="xml-wrapped"></a>wrapped | `boolean` | MAY be used only for an array definition. Signifies whether the array is wrapped (for example, `<books><book/><book/></books>`) or unwrapped (`<book/><book/>`). Default value is `false`. The definition takes effect only when defined alongside `type` being `"array"` (outside the `items`). If `nodeType` is present, this field MUST NOT be present.<br /><br />**Deprecated:** Set `nodeType: "element"` explicitly in place of `wrapped: true` |
+| <a name="xml-attribute"></a>attribute | `boolean` | Declares whether the property definition translates to an attribute instead of an element. Default value is `false`. If `nodeType` is present, this field MUST NOT be present.<br /><br />**Deprecated:** Use `nodeType: "attribute"` instead of `attribute: true` |
+| <a name="xml-wrapped"></a>wrapped | `boolean` | MAY be used only for an array definition. Signifies whether the array is wrapped (for example, `<books><book/><book/></books>`) or unwrapped (`<book/><book/>`). Default value is `false`. The definition takes effect only when defined alongside `type` being `"array"` (outside the `items`). If `nodeType` is present, this field MUST NOT be present.<br /><br />**Deprecated:** Use `nodeType: "element"` instead of `wrapped: true` |
 
 Note that when generating an XML document from object data, the order of the nodes is undefined.
 Use `prefixItems` to control node ordering as shown under [Ordered Elements and Text](#ordered-elements-and-text).

src/schemas/validation/meta.yaml

@@ -15,7 +15,8 @@ type:
 properties:
   discriminator:
     $ref: '#/$defs/discriminator'
-  example: true
+  example:
+    deprecated: true
   externalDocs:
     $ref: '#/$defs/external-docs'
   xml:
@@ -33,8 +34,6 @@ $defs:
         type: string
       propertyName:
         type: string
-    required:
-      - propertyName
     type: object
     unevaluatedProperties: false
 
@@ -74,8 +73,10 @@ $defs:
         type: string
       attribute:
         type: boolean
+        deprecated: true
       wrapped:
         type: boolean
+        deprecated: true
     type: object
     dependentSchemas:
       nodeType: