Add oas example of change validation

Author: mkistler

aip/general/0163/aip.md.j2

@@ -67,4 +67,12 @@ live request is likely to succeed, but is not a full guarantee of success.
 - In protocol buffers, the same response type is always used for a single RPC.
   The operation **may** return the response message with no fields populated.
 
+{% tab operations %}
+
+{% sample 'standard_operation.oas.yaml', 'paths' %}
+
+- The `dryRun` query parameter **must** be `type: boolean`.
+- The `dryRun` query parameter **must not** be `required: true`.
+- createBook could also return a 204 response if `dryRun` is `true`.
+
 {% endtabs %}

aip/general/0163/standard_operation.oas.yaml

@@ -0,0 +1,68 @@
+openapi: 3.0.3
+info:
+  title: Library
+  version: 1.0.0
+paths:
+  /publishers/{publisherId}/books/{bookId}:
+    parameters:
+      - name: publisherId
+        in: path
+        description: The id of the book publisher.
+        required: true
+        schema:
+          type: string
+      - name: bookId
+        in: path
+        description: The id of the book.
+        required: true
+        schema:
+          type: string
+    patch:
+      operationId: createBook
+      description: Create a single book.
+      requestBody:
+        content:
+          application/json:
+            schema:
+              $ref: '#/components/schemas/Book'       
+      parameters:
+        - name: dryRun
+          in: query
+          description: |
+            If set, validate the request and preview the book,
+            but do not actually post it.
+          schema:
+            type: boolean
+      responses:
+        '200':
+          description: OK
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/Book'
+components:
+  schemas:
+    Book:
+      description: A representation of a single book.
+      type: object
+      properties:
+        name:
+          type: string
+          description: |
+            The name of the book.
+            Format: publishers/{publisher}/books/{book}
+        isbn:
+          type: string
+          description: |
+            The ISBN (International Standard Book Number) for this book.
+        title:
+          type: string
+          description: The title of the book.
+        authors:
+          type: array
+          items:
+            type: string
+          description: The author or authors of the book.
+        rating:
+          type: number
+          description: The rating assigned to the book.