DOCS: updated Interactions doc with tips for multi-interactions (#1912)

* updated Interactions doc with tips for multi-interactions

Author: smnwttbr

Packages/com.unity.inputsystem/CHANGELOG.md

@@ -43,6 +43,7 @@ however, it has to be formatted properly to pass verification tests.
 ## [1.8.2] - 2024-04-29
 
 ### Added
+- Documentation to clarify effects of ordering of interactions when a single action has multiple interactions [ISXB-221](https://issuetracker.unity3d.com/product/unity/issues/guid/ISXB-221).
 - Additional tests for UI Input default actions (Navigate, Submit, Scroll etc.)
 
 ### Fixed

Packages/com.unity.inputsystem/Documentation~/Interactions.md

@@ -79,6 +79,8 @@ If multiple Interactions are present on a single Binding or Action, then the Inp
 
 At any one time, only one Interaction can be "driving" the action (that is, it gets to determine the action's current [`phase`](../api/UnityEngine.InputSystem.InputAction.html#UnityEngine_InputSystem_InputAction_phase)). If an Interaction higher up in the stack cancels, Interactions lower down in the stack can take over.
 
+Note that the order of interactions can affect which interaction is passed to your callback function. For example, an action with [Tap](#tap), [MultiTap](#multitap) and [Hold](#hold) interactions will have different behaviour when the interactions are in a different order, such as [Hold](#hold), [MultiTap](#multitap) and [Tap](#tap). If you get unexpected behaviour, you may need to experiment with a different ordering.
+
 ### Timeouts
 
 Interactions might need to wait a certain time for a specific input to occur or to not occur. An example of this is the [Hold](#hold) interaction which, after a button is pressed, has to wait for a set [duration](../api/UnityEngine.InputSystem.Interactions.HoldInteraction.html#UnityEngine_InputSystem_Interactions_HoldInteraction_duration) until the "hold" is complete. To do this, an interaction installs a timeout using [`SetTimeout`](../api/UnityEngine.InputSystem.InputInteractionContext.html#UnityEngine_InputSystem_InputInteractionContext_SetTimeout_System_Single_).