Henry's remarks

Author: ralfhandl

src/oas.md

@@ -2071,7 +2071,7 @@ requestBody:
             type: string
           icon:
             # The default content type with `contentEncoding` present
-            # is "application/octet-stream", so we need to set the correct
+            # is `application/octet-stream`, so we need to set the correct
             # image media type(s) in the Encoding Object.
             type: string
             contentEncoding: base64url
@@ -2128,20 +2128,20 @@ requestBody:
         type: object
         properties:
           # default content type for a string without `contentEncoding`
-          # is "text/plain"
+          # is `text/plain`
           id:
             type: string
             format: uuid
 
           # default content type for a schema without `type`
-          # is "application/octet-stream"
+          # is `application/octet-stream`
           profileImage: {}
 
           # for arrays, the `encoding` field applies the Encoding Object
           # to each item individually and determines the default content type
           # based on the type in the `items` subschema, which in this example
           # is an object, so the default content type for each item is
-          # "application/json"
+          # `application/json`
           addresses:
             type: array
             items:
@@ -2160,13 +2160,13 @@ requestBody:
       schema:
         type: object
         properties:
-          # No Encoding Object, so use default "text/plain"
+          # No Encoding Object, so use default `text/plain`
           id:
             type: string
             format: uuid
 
-          # Encoding Object overrides the default "application/json" content type
-          # for each item in the array with "application/xml; charset=utf-8"
+          # Encoding Object overrides the default `application/json` content type
+          # for each item in the array with `application/xml; charset=utf-8`
           addresses:
             description: addresses in XML format
             type: array
@@ -2217,7 +2217,7 @@ multipart/mixed:
     type: array
     prefixItems:
     - # default content type for objects
-      # is "application/json"
+      # is `application/json`
       type: object
       properties:
         author:
@@ -2230,7 +2230,7 @@ multipart/mixed:
         license:
           type: string
     - # default content type for a schema without `type`
-      # is "application/octet-stream", which we need
+      # is `application/octet-stream`, which we need
       # to override.
       {}
   prefixEncoding:
@@ -5395,7 +5395,7 @@ components:
 In this example, the retrieval URIs are irrelevant because both documents define `$self`.
 
 The relative `$ref` in the first document is resolved against `$self` to produce `https://example.com/api/shared/foo#/components/requestBodies/Foo`.
-The portion of that URI before the "#" matches the `$self` of the second document, so the reference target is resolved to `#/components/requestBodies/Foo` in that second document.
+The portion of that URI before the `#` matches the `$self` of the second document, so the reference target is resolved to `#/components/requestBodies/Foo` in that second document.
 
 In that document, the `$ref` in the Request Body Object is resolved using that document's `$self` as the base URI, producing `https://example.com/api/schemas/foo`.
 This matches the `$id` at `#/components/schemas/Foo/$id` so it points to that Schema Object.