address review feedback

content/client-server-api/_index.md

@@ -2823,7 +2823,7 @@ the following places:
 * [`invite_state`](#get_matrixclientv3sync_response-200_invited-room) and
   [`knock_state`](#get_matrixclientv3sync_response-200_knocked-room) on
   [`/sync`](#get_matrixclientv3sync) responses.
-* When present on [`m.room.member`](#mroommember) events, the `invite_room_state`
+* On [`m.room.member`](#mroommember) events, the `invite_room_state`
   and `knock_room_state` under `unsigned` on the event.
 
 {{% boxes/note %}}

data/api/server-server/invites-v1.yaml

@@ -97,8 +97,6 @@ paths:
                               Note that events have a different format depending on the room
                               version - check the [room version specification](/rooms) for
                               precise event formats.
-                          example:
-                            $ref: ./examples/invite_or_knock_state.json
               type: object
         required: true
       responses:

data/api/server-server/invites-v2.yaml

@@ -98,8 +98,6 @@ paths:
                       Note that events have a different format depending on the room
                       version - check the [room version specification](/rooms) for
                       precise event formats.
-                  example:
-                    $ref: ./examples/invite_or_knock_state.json
               required:
                 - room_version
                 - event

data/api/server-server/knocks.yaml

@@ -294,6 +294,7 @@ paths:
                     type: array
                     items:
                       type: object
+                      title: PDU
                       properties: {}
                       description: |-
                         Note that events have a different format depending on the room