address error messages for swagger-api#1808's Swagger 2.0 example

clarifies the schema and adds custom error messages for unclear error conditions

Author: shockey

src/plugins/json-schema-validator/swagger2-schema.yaml

@@ -251,10 +251,15 @@ definitions:
         $ref: "#/definitions/vendorExtension"
     not:
       type: object
+      minProperties: 1
       additionalProperties: false
       patternProperties:
         "^x-":
           $ref: "#/definitions/vendorExtension"
+    errorMessage:
+      minProperties: "should define at least one response"
+      not: "should define at least one response, in addition to any vendor extension (`x-*`) fields"
+      additionalProperties: "should only have three-digit status codes, `default`, and vendor extensions (`x-*`) as properties"
   responseValue:
     oneOf:
     - $ref: "#/definitions/response"

src/plugins/json-schema-validator/validator/index.js

@@ -75,11 +75,6 @@ function jsonPointerStringToArray(str) {
     .filter(str => str.length > 0)
 }
 
-// For completeness, if we need to denormalize the key...
-// function JSONPointerToPath(str) {
-//   return str.split('/').map(a => a.replace('~1', '/').replace('~0', '~'))
-// }
-
 // Convert arrays into a string. Safely, by using the JSONPath spec
 function normalizeKey(key) {
   if (!Array.isArray(key)) key = [key]