File tree Expand file tree Collapse file tree 1 file changed +10
-1
lines changed
src/Microsoft.OpenApi/Validations/Rules Expand file tree Collapse file tree 1 file changed +10
-1
lines changed Original file line number Diff line number Diff line change @@ -8,7 +8,16 @@ namespace Microsoft.OpenApi.Validations.Rules
8
8
/// <summary>
9
9
/// The validation rules for <see cref="OpenApiMediaType"/>.
10
10
/// </summary>
11
- [ OpenApiRule ]
11
+ /// <remarks>
12
+ /// Removed this in v1.3 as a default rule as the OpenAPI specification does not require that example
13
+ /// values validate against the schema. Validating examples against the schema is particularly difficult
14
+ /// as it requires parsing of the example using the schema as a guide. This is not possible when the schema
15
+ /// is ref'd. Even if we fix this issue, this rule should be treated as a warning, not an error
16
+ /// Future versions of the validator should make that distinction.
17
+ /// Future versions of the example parsers should not try an infer types.
18
+ /// Example validation should be done as a separate post reading step so all schemas can be fully available.
19
+ /// </remarks>
20
+ //[OpenApiRule]
12
21
public static class OpenApiMediaTypeRules
13
22
{
14
23
/// <summary>
You can’t perform that action at this time.
0 commit comments