update recommended and spec

Author: tatomyr

__tests__/lint/oas3.1/openapi.yaml

@@ -34,7 +34,7 @@ paths:
               schema:
                 type: array
                 prefixItems:
-                  - type: 'string'
+                  - type: string
                 items: false
         400:
           description: An error response
@@ -109,10 +109,10 @@ paths:
   /unevaluated-properties:
     get:
       operationId: getUnevaluatedProperties
-      summary: Checks if unevaluetedProperties work
+      summary: Checks if unevaluatedProperties work
       responses:
         200:
-          description: 'OK'
+          description: OK
           content:
             application/json:
               schema:
@@ -177,11 +177,11 @@ components:
   pathItems: {}
   schemas:
     Problem:
-      id: 'https://tools.ietf.org/rfc/rfc7807.txt'
+      id: https://tools.ietf.org/rfc/rfc7807.txt
       $schema: 'http://json-schema.org/draft-06/schema#'
-      description: 'schema for a rfc7807'
+      description: schema for a rfc7807
       definitions: {}
-      type: 'object'
+      type: object
       properties:
         type:
           description: A URI reference [RFC3986] that identifies the problem type.

__tests__/lint/oas3.1/snapshot.txt

@@ -1,12 +1,33 @@
-[1] openapi.yaml:179:5 at #/components/schemas/Problem
+[1] openapi.yaml:180:7 at #/components/schemas/Problem/schema
+
+Example validation errored: NOT SUPPORTED: keyword "id", use "$id" for schema ID.
+
+178 | schemas:
+179 |   Problem:
+180 |     id: https://tools.ietf.org/rfc/rfc7807.txt
+    |     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+181 |     $schema: 'http://json-schema.org/draft-06/schema#'
+    |     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+  … |     < 32 more lines >
+214 |   Pet:
+    |   ^
+215 |     required:
+216 |       - id
+
+referenced from openapi.yaml:180:7 at #/components/schemas/Problem 
+
+Warning was generated by the no-invalid-schema-examples rule.
+
+
+[2] openapi.yaml:179:5 at #/components/schemas/Problem
 
 Component: "Problem" is never used.
 
 177 | pathItems: {}
 178 | schemas:
 179 |   Problem:
     |   ^^^^^^^
-180 |     id: 'https://tools.ietf.org/rfc/rfc7807.txt'
+180 |     id: https://tools.ietf.org/rfc/rfc7807.txt
 181 |     $schema: 'http://json-schema.org/draft-06/schema#'
 
 Warning was generated by the no-unused-components rule.
@@ -17,5 +38,5 @@ validating openapi.yaml using lint rules for api 'main'...
 openapi.yaml: validated in <test>ms
 
 Woohoo! Your API description is valid. 🎉
-You have 1 warning.
+You have 2 warnings.
 

docs/@v2/rules/recommended.md

@@ -27,7 +27,6 @@ Errors:
 - [path-declaration-must-exist](./oas/path-declaration-must-exist.md)
 - [path-not-include-query](./oas/path-not-include-query.md)
 - [path-parameters-defined](./oas/path-parameters-defined.md)
-- [path-params-defined](./oas/path-parameters-defined.md)
 - [security-defined](./oas/security-defined.md)
 - [sourceDescription-name-unique](./arazzo/sourceDescriptions-name-unique.md)
 - [sourceDescription-type](./arazzo/sourceDescriptions-type.md)

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

@@ -21,7 +21,6 @@ All the rules are of severity `error`:
 - [path-declaration-must-exist](./oas/path-declaration-must-exist.md)
 - [path-not-include-query](./oas/path-not-include-query.md)
 - [path-parameters-defined](./oas/path-parameters-defined.md)
-- [path-params-defined](./oas/path-parameters-defined.md)
 - [requestBody-replacements-unique](./arazzo/requestBody-replacements-unique.md)
 - [sourceDescription-name-unique](./arazzo/sourceDescriptions-name-unique.md)
 - [sourceDescription-type](./arazzo/sourceDescriptions-type.md)