add warning to description

Author: ben-kalmus

specs/composition/paths/compositions/updateSortingStrategy.yml

@@ -8,7 +8,10 @@ post:
   description: |
     Updates the "sortingStrategy" field of an existing composition.
     This endpoint allows you to create a new sorting strategy mapping or replace the currently configured one.
-    The provided sorting indices must be associated indices or replicas of the main targeted index.
+    The provided sorting indices MUST be associated indices or replicas of the main targeted index.
+
+    WARNING: This endpoint cannot validate if the sort index is related to the composition's main index.
+      Validation will fail at runtime if the index you updated is not related!
 
     The update is applied to the specified composition within the current Algolia application and returns a taskID that can be used to track the operation’s completion.
   parameters: