Clarify invite/request response descriptions. (#464)

Author: Raphiiko

openapi/components/paths/invite.yaml

@@ -234,7 +234,11 @@ paths:
       operationId: respondInvite
       security:
         - authCookie: []
-      description: 'Respond to an invite request by sending a world invite to the requesting user. `:notificationId` is the ID of the requesting notification.'
+      description: |-
+        Respond to an invite or invite request without accepting it. `:notificationId` is the ID of the requesting notification.
+
+        In case the notification being replied to is an invite, the `responseSlot` refers to a response message from the the `message` collection.
+        In case the notification is an invite request, it will refer to one from the `requestResponse` collection instead.
       requestBody:
         required: true
         content:
@@ -259,7 +263,11 @@ paths:
       operationId: respondInviteWithPhoto
       security:
         - authCookie: []
-      description: 'Respond with photo to an invite request by sending a world invite to the requesting user. `:notificationId` is the ID of the requesting notification.'
+      description: |-
+        Respond with photo to an invite or invite request without accepting it. `:notificationId` is the ID of the requesting notification.
+
+        In case the notification being replied to is an invite, the `responseSlot` refers to a response message from the the `message` collection.
+        In case the notification is an invite request, it will refer to one from the `requestResponse` collection instead.'
       requestBody:
         required: true
         content: