fix rulesets and the templates

Author: tatomyr

docs/@v2/rules/minimal.md

@@ -24,7 +24,6 @@ Warnings:
 - [no-example-value-and-externalValue](./oas/no-example-value-and-externalValue.md)
 - [no-identical-paths](./oas/no-identical-paths.md)
 - [no-invalid-media-type-examples](./oas/no-invalid-media-type-examples.md)
-- [no-invalid-tag-parents](./oas/no-invalid-tag-parents.md)
 - [no-path-trailing-slash](./oas/no-path-trailing-slash.md)
 - [no-required-schema-properties-undefined](./common/no-required-schema-properties-undefined.md)
 - [no-schema-type-mismatch](./common/no-schema-type-mismatch.md)
@@ -43,6 +42,8 @@ Warnings:
 - [path-parameters-defined](./oas/path-parameters-defined.md)
 - [security-defined](./oas/security-defined.md)
 - [spec-components-invalid-map-name](./oas/spec-components-invalid-map-name.md)
+- [spec-no-invalid-encoding-combinations](./oas/spec-no-invalid-encoding-combinations.md)
+- [spec-no-invalid-tag-parents](./oas/spec-no-invalid-tag-parents.md)
 - [tag-description](./oas/tag-description.md)
 
 A copy-pastable version of this ruleset is available as a [ruleset template](./ruleset-templates.md).

docs/@v2/rules/recommended.md

@@ -12,7 +12,6 @@ Errors:
 - [no-enum-type-mismatch](./common/no-enum-type-mismatch.md)
 - [no-example-value-and-externalValue](./oas/no-example-value-and-externalValue.md)
 - [no-identical-paths](./oas/no-identical-paths.md)
-- [no-invalid-tag-parents](./oas/no-invalid-tag-parents.md)
 - [no-path-trailing-slash](./oas/no-path-trailing-slash.md)
 - [no-schema-type-mismatch](./common/no-schema-type-mismatch.md)
 - [no-server-trailing-slash](./oas/no-server-trailing-slash.md)
@@ -34,6 +33,9 @@ Errors:
 - [sourceDescription-type](./arazzo/sourceDescriptions-type.md)
 - [sourceDescriptions-not-empty](./arazzo/sourceDescriptions-not-empty.md)
 - [spec-components-invalid-map-name](./oas/spec-components-invalid-map-name.md)
+- [spec-example-values](./oas/spec-example-values.md)
+- [spec-no-invalid-encoding-combinations](./oas/spec-no-invalid-encoding-combinations.md)
+- [spec-no-invalid-tag-parents](./oas/spec-no-invalid-tag-parents.md)
 - [stepId-unique](./arazzo/stepId-unique.md)
 - [struct](./common/struct.md)
 - [workflow-dependsOn](./arazzo/workflow-dependsOn.md)
@@ -57,6 +59,7 @@ Warnings:
 - [operation-4xx-response](./oas/operation-4xx-response.md)
 - [operation-operationId](./oas/operation-operationId.md)
 - [requestBody-replacements-unique](./arazzo/requestBody-replacements-unique.md)
+- [spec-discriminator-defaultMapping](./oas/spec-discriminator-defaultMapping.md)
 - [step-onFailure-unique](./arazzo/step-onFailure-unique.md)
 - [step-onSuccess-unique](./arazzo/step-onSuccess-unique.md)
 - [tag-description](./oas/tag-description.md)

docs/@v2/rules/ruleset-templates.md

@@ -14,9 +14,7 @@ More information and examples for individual rules can be found in the [built-in
 
 The minimal rulesets are a decent baseline that you can use to selective enable more rules or extend rulesets from.
 
-<!-- FIXME: update according to recommended/minimal/spec &c. -->
-
-### Minimal ruleset: OpenAPI 3.1/3.2
+### Minimal ruleset: OpenAPI 3.2
 
 ```yaml
 rules:
@@ -60,7 +58,6 @@ rules:
   no-server-example.com: warn
   no-server-trailing-slash: error
   no-empty-servers: warn
-  no-example-value-and-externalValue: warn
   no-unused-components: warn
   no-undefined-server-variable: warn
   no-server-variables-empty-enum: error
@@ -82,6 +79,69 @@ rules:
   spec-no-invalid-encoding-combinations: warn
 ```
 
+### Minimal ruleset: OpenAPI 3.1
+
+```yaml
+rules:
+  info-contact: off
+  info-license: off
+  info-license-strict: off
+  tag-description: warn
+  tags-alphabetical: off
+  parameter-description: off
+  no-path-trailing-slash: warn
+  no-identical-paths: warn
+  no-ambiguous-paths: warn
+  path-declaration-must-exist: warn
+  path-not-include-query: warn
+  path-parameters-defined: warn
+  operation-description: off
+  operation-2xx-response: warn
+  operation-4xx-response: off
+  operation-operationId: warn
+  operation-summary: warn
+  operation-operationId-unique: warn
+  operation-parameters-unique: warn
+  operation-tag-defined: off
+  security-defined: warn
+  operation-operationId-url-safe: warn
+  operation-singular-tag: off
+  no-unresolved-refs: error
+  paths-kebab-case: off
+  struct: error
+  spec-strict-refs: off
+  no-http-verbs-in-paths: off
+  no-invalid-parameter-examples: off
+  no-invalid-schema-examples: off
+  path-http-verbs-order: off
+  path-params-defined: off
+  required-string-property-missing-min-length: off
+  response-contains-header: off
+  path-segment-plural: off
+  scalar-property-missing-example: off
+  no-invalid-media-type-examples: warn
+  no-server-example.com: warn
+  no-server-trailing-slash: error
+  no-empty-servers: warn
+  no-example-value-and-externalValue: warn
+  no-unused-components: warn
+  no-undefined-server-variable: warn
+  no-server-variables-empty-enum: error
+  spec-components-invalid-map-name: warn
+  boolean-parameter-prefixes: off
+  component-name-unique: off
+  operation-4xx-problem-details-rfc7807: off
+  request-mime-type: off
+  response-contains-property: off
+  response-mime-type: off
+  array-parameter-serialization: off
+  no-duplicated-tag-names: off
+  no-required-schema-properties-undefined: warn
+  no-schema-type-mismatch: warn
+  no-enum-type-mismatch: warn
+  spec-example-values: off
+```
+
 ### Minimal ruleset: OpenAPI 3.0
 
 ```yaml
@@ -143,6 +203,7 @@ rules:
   no-required-schema-properties-undefined: warn
   no-schema-type-mismatch: warn
   no-enum-type-mismatch: warn
+  spec-example-values: off
 ```
 
 ### Minimal ruleset: OpenAPI 2.0
@@ -240,14 +301,14 @@ rules:
   workflowId-unique: error
   stepId-unique: error
   sourceDescription-name-unique: off
+  sourceDescriptions-not-empty: off
   workflow-dependsOn: off
   parameters-unique: off
   step-onSuccess-unique: off
   step-onFailure-unique: off
   respect-supported-versions: off
   requestBody-replacements-unique: off
   no-criteria-xpath: off
-  no-actions-type-end: off
   criteria-unique: off
   no-x-security-scheme-name-without-openapi: off
   x-security-scheme-required-values: off
@@ -263,7 +324,7 @@ The default behavior is to use a recommended ruleset.
 The recommended rulesets for each format are listed below.
 There is also a "recommended-strict" ruleset which is identical but with all `warn` settings changed to `error`.
 
-### Recommended ruleset: OpenAPI 3.1/3.2
+### Recommended ruleset: OpenAPI 3.2
 
 ```yaml
 rules:
@@ -295,14 +356,29 @@ rules:
   struct: error
   spec-strict-refs: off
   no-http-verbs-in-paths: off
-  no-invalid-parameter-examples: off
-  no-invalid-schema-examples: off
+  no-invalid-parameter-examples: warn
+  no-invalid-schema-examples: warn
   path-http-verbs-order: off
-  path-params-defined: off
+  path-params-defined: error
   path-segment-plural: off
   required-string-property-missing-min-length: off
   response-contains-header: off
   scalar-property-missing-example: off
+  no-invalid-media-type-examples: warn
+  no-server-example.com: warn
+  no-server-trailing-slash: error
+  no-empty-servers: error
+  no-unused-components: warn
+  no-undefined-server-variable: error
+  no-server-variables-empty-enum: error
+  spec-components-invalid-map-name: error
+  boolean-parameter-prefixes: off
+  component-name-unique: off
+  operation-4xx-problem-details-rfc7807: off
+  request-mime-type: off
+  response-contains-property: off
+  response-mime-type: off
+  array-parameter-serialization: off
   no-duplicated-tag-names: warn
   no-required-schema-properties-undefined: warn
   no-schema-type-mismatch: error
@@ -313,6 +389,69 @@ rules:
   spec-no-invalid-encoding-combinations: error
 ```
 
+### Recommended ruleset: OpenAPI 3.1
+
+```yaml
+rules:
+  info-contact: off
+  info-license: warn
+  info-license-strict: warn
+  tag-description: warn
+  tags-alphabetical: off
+  parameter-description: off
+  no-path-trailing-slash: error
+  no-identical-paths: error
+  no-ambiguous-paths: warn
+  path-declaration-must-exist: error
+  path-not-include-query: error
+  path-parameters-defined: error
+  operation-description: off
+  operation-2xx-response: warn
+  operation-4xx-response: warn
+  operation-operationId: warn
+  operation-summary: error
+  operation-operationId-unique: error
+  operation-operationId-url-safe: error
+  operation-parameters-unique: error
+  operation-tag-defined: off
+  security-defined: error
+  operation-singular-tag: off
+  no-unresolved-refs: error
+  paths-kebab-case: off
+  struct: error
+  spec-strict-refs: off
+  no-http-verbs-in-paths: off
+  no-invalid-parameter-examples: warn
+  no-invalid-schema-examples: warn
+  path-http-verbs-order: off
+  path-params-defined: error
+  path-segment-plural: off
+  required-string-property-missing-min-length: off
+  response-contains-header: off
+  scalar-property-missing-example: off
+  no-invalid-media-type-examples: warn
+  no-server-example.com: warn
+  no-server-trailing-slash: error
+  no-empty-servers: error
+  no-example-value-and-externalValue: error
+  no-unused-components: warn
+  no-undefined-server-variable: error
+  no-server-variables-empty-enum: error
+  spec-components-invalid-map-name: error
+  boolean-parameter-prefixes: off
+  component-name-unique: off
+  operation-4xx-problem-details-rfc7807: off
+  request-mime-type: off
+  response-contains-property: off
+  response-mime-type: off
+  array-parameter-serialization: off
+  no-duplicated-tag-names: warn
+  no-required-schema-properties-undefined: warn
+  no-schema-type-mismatch: error
+  no-enum-type-mismatch: error
+  spec-example-values: off
+```
+
 ### Recommended ruleset: OpenAPI 3.0
 
 ```yaml
@@ -346,10 +485,10 @@ rules:
   struct: error
   spec-strict-refs: off
   no-http-verbs-in-paths: off
-  no-invalid-parameter-examples: off
-  no-invalid-schema-examples: off
+  no-invalid-parameter-examples: warn
+  no-invalid-schema-examples: warn
   path-http-verbs-order: off
-  path-params-defined: off
+  path-params-defined: error
   path-segment-plural: off
   required-string-property-missing-min-length: off
   response-contains-header: off
@@ -374,6 +513,7 @@ rules:
   no-required-schema-properties-undefined: warn
   no-schema-type-mismatch: error
   no-enum-type-mismatch: error
+  spec-example-values: off
 ```
 
 ### Recommended ruleset: OpenAPI 2.0
@@ -408,10 +548,10 @@ rules:
   struct: error
   spec-strict-refs: off
   no-http-verbs-in-paths: off
-  no-invalid-parameter-examples: off
-  no-invalid-schema-examples: off
+  no-invalid-parameter-examples: warn
+  no-invalid-schema-examples: warn
   path-http-verbs-order: off
-  path-params-defined: off
+  path-params-defined: error
   path-segment-plural: off
   required-string-property-missing-min-length: off
   response-contains-header: off
@@ -471,18 +611,18 @@ rules:
   workflowId-unique: error
   stepId-unique: error
   sourceDescription-name-unique: error
+  sourceDescriptions-not-empty: error
   workflow-dependsOn: error
   parameters-unique: error
   step-onSuccess-unique: warn
   step-onFailure-unique: warn
   respect-supported-versions: off
   requestBody-replacements-unique: warn
   no-criteria-xpath: off
-  no-actions-type-end: warn
   criteria-unique: warn
   no-x-security-scheme-name-without-openapi: off
   x-security-scheme-required-values: off
-  no-x-security-scheme-name-in-workflow: 'off',
+  no-x-security-scheme-name-in-workflow: off
   no-required-schema-properties-undefined: warn
   no-schema-type-mismatch: error
   no-enum-type-mismatch: error

docs/@v2/rules/spec-ruleset.md

@@ -27,6 +27,10 @@ All the rules are of severity `error`:
 - [sourceDescription-type](./arazzo/sourceDescriptions-type.md)
 - [sourceDescriptions-not-empty](./arazzo/sourceDescriptions-not-empty.md)
 - [spec-components-invalid-map-name](./oas/spec-components-invalid-map-name.md)
+- [spec-discriminator-defaultMapping](./oas/spec-discriminator-defaultMapping.md)
+- [spec-example-values](./oas/spec-example-values.md)
+- [spec-no-invalid-encoding-combinations](./oas/spec-no-invalid-encoding-combinations.md)
+- [spec-no-invalid-tag-parents](./oas/spec-no-invalid-tag-parents.md)
 - [spec-strict-refs](./oas/spec-strict-refs.md)
 - [step-onFailure-unique](./arazzo/step-onFailure-unique.md)
 - [step-onSuccess-unique](./arazzo/step-onSuccess-unique.md)