docs(federation): Add a hint which capabilities should be used in federation cases

Signed-off-by: Joas Schilling <coding@schilljs.com>

docs/conversation.md

@@ -484,6 +484,9 @@ Get all (for moderators and in case of "free selection") or the assigned breakou
 
 ## Get conversation capabilities
 
+See [Capability handling in federated conversations](https://github.com/nextcloud/spreed/issues/10680) to learn which capabilities
+should be considered from the local server or from the remote server.
+
 * Required capability: `federation-v1`
 * Method: `GET`
 * Endpoint: `/room/{token}/capabilities`

lib/Controller/RoomController.php

@@ -2239,6 +2239,9 @@ class RoomController extends AEnvironmentAwareController {
 	/**
 	 * Get capabilities for a room
 	 *
+	 * See "Capability handling in federated conversations" in https://github.com/nextcloud/spreed/issues/10680
+	 * to learn which capabilities should be considered from the local server or from the remote server.
+	 *
 	 * @return DataResponse<Http::STATUS_OK, TalkCapabilities|array<empty>, array{X-Nextcloud-Talk-Hash?: string, X-Nextcloud-Talk-Proxy-Hash?: string}>
 	 *
 	 * 200: Get capabilities successfully

openapi-full.json

@@ -15300,6 +15300,7 @@
             "get": {
                 "operationId": "room-get-capabilities",
                 "summary": "Get capabilities for a room",
+                "description": "See \"Capability handling in federated conversations\" in https://github.com/nextcloud/spreed/issues/10680 to learn which capabilities should be considered from the local server or from the remote server.",
                 "tags": [
                     "room"
                 ],

openapi.json

@@ -15410,6 +15410,7 @@
             "get": {
                 "operationId": "room-get-capabilities",
                 "summary": "Get capabilities for a room",
+                "description": "See \"Capability handling in federated conversations\" in https://github.com/nextcloud/spreed/issues/10680 to learn which capabilities should be considered from the local server or from the remote server.",
                 "tags": [
                     "room"
                 ],

src/types/openapi/openapi-full.ts

@@ -349,7 +349,10 @@ export type paths = {
     post: operations["room-set-message-expiration"];
   };
   "/ocs/v2.php/apps/spreed/api/{apiVersion}/room/{token}/capabilities": {
-    /** Get capabilities for a room */
+    /**
+     * Get capabilities for a room
+     * @description See "Capability handling in federated conversations" in https://github.com/nextcloud/spreed/issues/10680 to learn which capabilities should be considered from the local server or from the remote server.
+     */
     get: operations["room-get-capabilities"];
   };
   "/ocs/v2.php/apps/spreed/api/{apiVersion}/settings/user": {
@@ -5243,7 +5246,10 @@ export type operations = {
       };
     };
   };
-  /** Get capabilities for a room */
+  /**
+   * Get capabilities for a room
+   * @description See "Capability handling in federated conversations" in https://github.com/nextcloud/spreed/issues/10680 to learn which capabilities should be considered from the local server or from the remote server.
+   */
   "room-get-capabilities": {
     parameters: {
       header: {

src/types/openapi/openapi.ts

@@ -353,7 +353,10 @@ export type paths = {
     post: operations["room-set-message-expiration"];
   };
   "/ocs/v2.php/apps/spreed/api/{apiVersion}/room/{token}/capabilities": {
-    /** Get capabilities for a room */
+    /**
+     * Get capabilities for a room
+     * @description See "Capability handling in federated conversations" in https://github.com/nextcloud/spreed/issues/10680 to learn which capabilities should be considered from the local server or from the remote server.
+     */
     get: operations["room-get-capabilities"];
   };
   "/ocs/v2.php/apps/spreed/api/{apiVersion}/settings/user": {
@@ -5144,7 +5147,10 @@ export type operations = {
       };
     };
   };
-  /** Get capabilities for a room */
+  /**
+   * Get capabilities for a room
+   * @description See "Capability handling in federated conversations" in https://github.com/nextcloud/spreed/issues/10680 to learn which capabilities should be considered from the local server or from the remote server.
+   */
   "room-get-capabilities": {
     parameters: {
       header: {