Last minute tweaks add to instance

Author: Phil Sturgeon

content/getting-specific-about-apis/source.md

@@ -431,7 +431,7 @@ GET /hats
 Link: <http://example.com/schemas/hats.json#>; rel=”describedby”
 ```
 
-Now you know what a collection of hats look like...
+Now clients know what a collection of hats look like...
 
 ---
 
@@ -444,7 +444,7 @@ Now you know what a collection of hats look like...
 }
 ```
 
-And you know what a hat looks like...
+And now clients know what a hat looks like...
 
 ---
 
@@ -835,15 +835,67 @@ Avoid writing careful OpenAPI-flavoured JSON Schema
 
 Just write proper JSON Schema™!
 
+[wework/json-schema-to-openapi-schema](https://github.com/wework/json-schema-to-openapi-schema)
+
+---
+
+```
+const toOpenApi = require('json-schema-to-openapi-schema');
+
+const schema = {
+  '$schema': 'http://json-schema.org/draft-04/schema#',
+  type: ['string', 'null'],
+  format: 'date-time',
+};
+
+console.log(toOpenApi(schema));
+```
+
+```
+{
+  type: 'string',
+  format: 'date-time',
+  nullable: true
+}
+```
+
 ---
 
+Validators like speccy fail...
 
+```
+$ speccy lint docs/openapi.yml
+Specification schema is invalid.
+
+#/paths/~1invalidations/post/requestBody/content/application~1json/properties/user_uuid
+expected Array [ 'string', 'null' ] to be a string
+    expected Array [ 'string', 'null' ] to have type string
+        expected 'object' to be 'string'
+```
 
-TODO alt example
+---
+
+But speccy has a `--json-schema` switch
+
+```
+$ speccy lint docs/openapi.yml --json-schema
+Specification is valid, with 0 lint errors
+```
 
 ---
 
-TODO Speccy example hack
+OpenAPI have a feature in "draft"
+
+```
+schema:
+  alternativeSchema:
+    type: jsonSchema
+    location: ./real-jsonschema.json
+```
+
+(probably going in v3.1)
+
+---
 
 <!-- .slide: data-background="img/book.jpg" data-background-size="contain" -->
 

instances/18-capitalone/getting-specific-about-apis/html/index.html

@@ -335,7 +335,7 @@
 Link: <http://example.com/schemas/hats.json#>; rel=”describedby”
 ```
 
-Now you know what a collection of hats look like...
+Now clients know what a collection of hats look like...
 </script></section><section  data-markdown><script type="text/template">
 ```
 {
@@ -346,7 +346,7 @@
 }
 ```
 
-And you know what a hat looks like...
+And now clients know what a hat looks like...
 </script></section><section  data-markdown><script type="text/template">
 ``` js
 const Ajv = require('ajv');
@@ -652,13 +652,59 @@
 Avoid writing careful OpenAPI-flavoured JSON Schema
 
 Just write proper JSON Schema™!
+
+[wework/json-schema-to-openapi-schema](https://github.com/wework/json-schema-to-openapi-schema)
+</script></section><section  data-markdown><script type="text/template">
+```
+const toOpenApi = require('json-schema-to-openapi-schema');
+
+const schema = {
+  '$schema': 'http://json-schema.org/draft-04/schema#',
+  type: ['string', 'null'],
+  format: 'date-time',
+};
+
+console.log(toOpenApi(schema));
+```
+
+```
+{
+  type: 'string',
+  format: 'date-time',
+  nullable: true
+}
+```
 </script></section><section  data-markdown><script type="text/template">
+Validators like speccy fail...
 
+```
+$ speccy lint docs/openapi.yml
+Specification schema is invalid.
 
-TODO alt example
+#/paths/~1invalidations/post/requestBody/content/application~1json/properties/user_uuid
+expected Array [ 'string', 'null' ] to be a string
+    expected Array [ 'string', 'null' ] to have type string
+        expected 'object' to be 'string'
+```
 </script></section><section  data-markdown><script type="text/template">
-TODO Speccy example hack
+But speccy has a `--json-schema` switch
 
+```
+$ speccy lint docs/openapi.yml --json-schema
+Specification is valid, with 0 lint errors
+```
+</script></section><section  data-markdown><script type="text/template">
+OpenAPI have a feature in "draft"
+
+```
+schema:
+  alternativeSchema:
+    type: jsonSchema
+    location: ./real-jsonschema.json
+```
+
+(probably going in v3.1)
+</script></section><section  data-markdown><script type="text/template">
 <!-- .slide: data-background="img/book.jpg" data-background-size="contain" -->
 
 <br/>