[Docs] Add diagram about hedging's context and callbacks

docs/strategies/hedging.md

@@ -471,6 +471,45 @@ Some insights about the hedging callback behavior in relation to hedging context
 > [!NOTE]
 > The hedging strategy ensures that both `ActionGenerator` and `OnHedging` are never executed concurrently. Any modifications to the contexts are thread-safe in these callbacks.
 
+### Sequence diagram about contexts and callbacks
+
+For the sake of conciseness the `Caller` is not depicted on the diagram.
+
+```mermaid
+sequenceDiagram
+    autonumber
+    participant P as Pipeline
+    participant H as Hedging
+    participant AG as ActionGenerator
+    participant UC as UserCallback
+    participant HUC as HedgedUserCallback
+    participant OH as OnHedging
+
+    P->>H: Calls ExecuteCore <br/>with Primary Context
+    H-->>H: Deep clones <br/>Primary Context
+
+    H->>+UC: Invokes <br/>with Primary Context
+    UC-->>UC: Processes <br/>+ Modifies Context
+    UC->>-H: Fails
+
+    H-->>H: Deep clones <br/>Primary Context
+    H->>+AG: Invokes <br/>with both Contexts
+    AG-->>AG: Modifies Primary Context
+    AG->>-H: Returns factory
+
+    H->>+OH: Invokes <br/>with both Contexts
+    OH-->>OH: Executes callback <br/>+ Modifies Action Context
+    OH->>-H: Finishes
+
+    H-->>H: Invokes factory
+    H->>+HUC: Invokes <br/>with Action Context
+    HUC-->>HUC: Processes <br/>+ Modifies Context
+    HUC->>-H: Fails
+
+    H-->>H: Merges Action Context <br/>onto Primary Context
+    H->>P: Propagates failure <br/>with Primary Context
+```
+
 ## Action generator
 
 The hedging options include an `ActionGenerator` property, allowing you to customize the actions executed during hedging. By default, the `ActionGenerator` returns the original callback passed to the strategy. The original callback also includes any logic introduced by subsequent resilience strategies. For more advanced scenarios, the `ActionGenerator` can be used to return entirely new hedged actions, as demonstrated in the example below: